<HTML><HEAD><META CONTENT="text/html; charset=UTF-8" HTTP-EQUIV="Content-Type"/><TITLE>EMMA Coverage Report</TITLE><STYLE TYPE="text/css"> TABLE,TD,TH {border-style:solid; border-color:black;} TD,TH {background:white;margin:0;line-height:100%;padding-left:0.5em;padding-right:0.5em;} TD {border-width:0 1px 0 0;} TH {border-width:1px 1px 1px 0;} TR TD.h {color:red;} TABLE {border-spacing:0; border-collapse:collapse;border-width:0 0 1px 1px;} P,H1,H2,H3,TH {font-family:verdana,arial,sans-serif;font-size:10pt;} TD {font-family:courier,monospace;font-size:10pt;} TABLE.hdft {border-spacing:0;border-collapse:collapse;border-style:none;} TABLE.hdft TH,TABLE.hdft TD {border-style:none;line-height:normal;} TABLE.hdft TH.tl,TABLE.hdft TD.tl {background:#6699CC;color:white;} TABLE.hdft TD.nv {background:#6633DD;color:white;} .nv A:link {color:white;} .nv A:visited {color:white;} .nv A:active {color:yellow;} TABLE.hdft A:link {color:white;} TABLE.hdft A:visited {color:white;} TABLE.hdft A:active {color:yellow;} .in {color:#356085;} TABLE.s TD {padding-left:0.25em;padding-right:0.25em;} TABLE.s TD.l {padding-left:0.25em;padding-right:0.25em;text-align:right;background:#F0F0F0;} TABLE.s TR.z TD {background:#FF9999;} TABLE.s TR.p TD {background:#FFFF88;} TABLE.s TR.c TD {background:#CCFFCC;} A:link {color:#0000EE;text-decoration:none;} A:visited {color:#0000EE;text-decoration:none;} A:hover {color:#0000EE;text-decoration:underline;} TABLE.cn {border-width:0 0 1px 0;} TABLE.s {border-width:1px 0 1px 1px;} TD.h {color:red;border-width:0 1px 0 0;} TD.f {border-width:0 1px 0 1px;} TD.hf {color:red;border-width:0 1px 0 1px;} TH.f {border-width:1px 1px 1px 1px;} TR.cis TD {background:#F0F0F0;} TR.cis TD {border-width:1px 1px 1px 0;} TR.cis TD.h {color:red;border-width:1px 1px 1px 0;} TR.cis TD.f {border-width:1px 1px 1px 1px;} TR.cis TD.hf {color:red;border-width:1px 1px 1px 1px;} TD.b {border-style:none;background:transparent;line-height:50%;}  TD.bt {border-width:1px 0 0 0;background:transparent;line-height:50%;} TR.o TD {background:#F0F0F0;}TABLE.it {border-style:none;}TABLE.it TD,TABLE.it TH {border-style:none;}</STYLE></HEAD><BODY><TABLE CLASS="hdft" CELLSPACING="0" WIDTH="100%"><TR><TH CLASS="tl"><A HREF="http://www.eclemma.org/">EMMA</A> Coverage Report (generated Fri May 20 23:44:31 PDT 2011)</TH></TR><TR><TD CLASS="nv">[<A HREF="../FeatureReleaseEmmaReport.html">all classes</A>][<A HREF="5.html">jvm.jtacck.db</A>]</TD></TR></TABLE><H2>COVERAGE SUMMARY FOR SOURCE FILE [<SPAN CLASS="in">AwesomeCoreHandler.java</SPAN>]</H2><TABLE CELLSPACING="0" WIDTH="100%"><TR><TH>name</TH><TH>class, %</TH><TH>method, %</TH><TH>block, %</TH><TH>line, %</TH></TR><TR><TD>AwesomeCoreHandler.java</TD><TD>100% (1/1)</TD><TD CLASS="h">22%  (11/51)</TD><TD CLASS="h">10%  (158/1524)</TD><TD CLASS="h">9%   (34.4/365)</TD></TR></TABLE><H3>COVERAGE BREAKDOWN BY CLASS AND METHOD</H3><TABLE CLASS="cn" CELLSPACING="0" WIDTH="100%"><TR><TH CLASS="f">name</TH><TH>class, %</TH><TH>method, %</TH><TH>block, %</TH><TH>line, %</TH></TR><TR><TD CLASS="b"> </TD><TD CLASS="b"> </TD><TD CLASS="b"> </TD><TD CLASS="b"> </TD><TD CLASS="b"> </TD></TR><TR CLASS="cis"><TD CLASS="f">class <A HREF="#0">AwesomeCoreHandler</A></TD><TD>100% (1/1)</TD><TD CLASS="h">22%  (11/51)</TD><TD CLASS="h">10%  (158/1524)</TD><TD CLASS="h">9%   (34.4/365)</TD></TR><TR><TD CLASS="f"><A HREF="#0">AwesomeCoreHandler (): void</A></TD><TD> </TD><TD CLASS="h">0%   (0/1)</TD><TD CLASS="h">0%   (0/3)</TD><TD CLASS="h">0%   (0/1)</TD></TR><TR CLASS="o"><TD CLASS="f"><A HREF="#2">addClientSite (String, int, List, String): boolean</A></TD><TD> </TD><TD CLASS="h">0%   (0/1)</TD><TD CLASS="h">0%   (0/54)</TD><TD CLASS="h">0%   (0/11)</TD></TR><TR><TD CLASS="f"><A HREF="#3">addCourier (String, String, String, String, int, int, List): boolean</A></TD><TD> </TD><TD CLASS="h">0%   (0/1)</TD><TD CLASS="h">0%   (0/94)</TD><TD CLASS="h">0%   (0/20)</TD></TR><TR CLASS="o"><TD CLASS="f"><A HREF="#4">addUser (String, String, String, String, int, int): boolean</A></TD><TD> </TD><TD CLASS="h">0%   (0/1)</TD><TD CLASS="h">0%   (0/83)</TD><TD CLASS="h">0%   (0/14)</TD></TR><TR><TD CLASS="f"><A HREF="#5">changeClientSite (String, int, List, String): boolean</A></TD><TD> </TD><TD CLASS="h">0%   (0/1)</TD><TD CLASS="h">0%   (0/54)</TD><TD CLASS="h">0%   (0/11)</TD></TR><TR CLASS="o"><TD CLASS="f"><A HREF="#6">changeCourier (String, String, String, String, int, int, List): boolean</A></TD><TD> </TD><TD CLASS="h">0%   (0/1)</TD><TD CLASS="h">0%   (0/163)</TD><TD CLASS="h">0%   (0/27)</TD></TR><TR><TD CLASS="f"><A HREF="#7">changeHospital (int, String, String): boolean</A></TD><TD> </TD><TD CLASS="h">0%   (0/1)</TD><TD CLASS="h">0%   (0/45)</TD><TD CLASS="h">0%   (0/9)</TD></TR><TR CLASS="o"><TD CLASS="f"><A HREF="#8">changeShippingInformation (String, String, int, int, String): boolean</A></TD><TD> </TD><TD CLASS="h">0%   (0/1)</TD><TD CLASS="h">0%   (0/77)</TD><TD CLASS="h">0%   (0/18)</TD></TR><TR><TD CLASS="f"><A HREF="#9">changeSpecimenInfo (String, String, String, Map): boolean</A></TD><TD> </TD><TD CLASS="h">0%   (0/1)</TD><TD CLASS="h">0%   (0/78)</TD><TD CLASS="h">0%   (0/13)</TD></TR><TR CLASS="o"><TD CLASS="f"><A HREF="#a">changeUser (String, String, String, String, int, int): boolean</A></TD><TD> </TD><TD CLASS="h">0%   (0/1)</TD><TD CLASS="h">0%   (0/83)</TD><TD CLASS="h">0%   (0/14)</TD></TR><TR><TD CLASS="f"><A HREF="#b">checkLoc (Courier, ClientSite): boolean</A></TD><TD> </TD><TD CLASS="h">0%   (0/1)</TD><TD CLASS="h">0%   (0/14)</TD><TD CLASS="h">0%   (0/2)</TD></TR><TR CLASS="o"><TD CLASS="f"><A HREF="#c">closeConnection (): boolean</A></TD><TD> </TD><TD CLASS="h">0%   (0/1)</TD><TD CLASS="h">0%   (0/11)</TD><TD CLASS="h">0%   (0/6)</TD></TR><TR><TD CLASS="f"><A HREF="#d">getAllClientSites (): List</A></TD><TD> </TD><TD CLASS="h">0%   (0/1)</TD><TD CLASS="h">0%   (0/9)</TD><TD CLASS="h">0%   (0/5)</TD></TR><TR CLASS="o"><TD CLASS="f"><A HREF="#e">getAllCouriers (): List</A></TD><TD> </TD><TD CLASS="h">0%   (0/1)</TD><TD CLASS="h">0%   (0/9)</TD><TD CLASS="h">0%   (0/5)</TD></TR><TR><TD CLASS="f"><A HREF="#f">getAllShippingByUser (String): List</A></TD><TD> </TD><TD CLASS="h">0%   (0/1)</TD><TD CLASS="h">0%   (0/29)</TD><TD CLASS="h">0%   (0/5)</TD></TR><TR CLASS="o"><TD CLASS="f"><A HREF="#10">getAllShippingInformation (): List</A></TD><TD> </TD><TD CLASS="h">0%   (0/1)</TD><TD CLASS="h">0%   (0/9)</TD><TD CLASS="h">0%   (0/5)</TD></TR><TR><TD CLASS="f"><A HREF="#11">getAllSpecHelper (String, boolean): List</A></TD><TD> </TD><TD CLASS="h">0%   (0/1)</TD><TD CLASS="h">0%   (0/37)</TD><TD CLASS="h">0%   (0/6)</TD></TR><TR CLASS="o"><TD CLASS="f"><A HREF="#12">getAllSpecimens (): List</A></TD><TD> </TD><TD CLASS="h">0%   (0/1)</TD><TD CLASS="h">0%   (0/9)</TD><TD CLASS="h">0%   (0/5)</TD></TR><TR><TD CLASS="f"><A HREF="#13">getAllSpecimensByName (String): List</A></TD><TD> </TD><TD CLASS="h">0%   (0/1)</TD><TD CLASS="h">0%   (0/4)</TD><TD CLASS="h">0%   (0/1)</TD></TR><TR CLASS="o"><TD CLASS="f"><A HREF="#14">getAllSpecimensByUsername (String): List</A></TD><TD> </TD><TD CLASS="h">0%   (0/1)</TD><TD CLASS="h">0%   (0/4)</TD><TD CLASS="h">0%   (0/1)</TD></TR><TR><TD CLASS="f"><A HREF="#15">getAllUserTypes (): List</A></TD><TD> </TD><TD CLASS="h">0%   (0/1)</TD><TD CLASS="h">0%   (0/9)</TD><TD CLASS="h">0%   (0/5)</TD></TR><TR CLASS="o"><TD CLASS="f"><A HREF="#16">getAllUsers (): List</A></TD><TD> </TD><TD CLASS="h">0%   (0/1)</TD><TD CLASS="h">0%   (0/9)</TD><TD CLASS="h">0%   (0/5)</TD></TR><TR><TD CLASS="f"><A HREF="#17">getCheckLists (): CheckListPair</A></TD><TD> </TD><TD CLASS="h">0%   (0/1)</TD><TD CLASS="h">0%   (0/9)</TD><TD CLASS="h">0%   (0/5)</TD></TR><TR CLASS="o"><TD CLASS="f"><A HREF="#18">getClientSite (int): ClientSite</A></TD><TD> </TD><TD CLASS="h">0%   (0/1)</TD><TD CLASS="h">0%   (0/9)</TD><TD CLASS="h">0%   (0/4)</TD></TR><TR><TD CLASS="f"><A HREF="#19">getCourierInfo (String): Courier</A></TD><TD> </TD><TD CLASS="h">0%   (0/1)</TD><TD CLASS="h">0%   (0/10)</TD><TD CLASS="h">0%   (0/5)</TD></TR><TR CLASS="o"><TD CLASS="f"><A HREF="#1a">getCurrentPackages (): List</A></TD><TD> </TD><TD CLASS="h">0%   (0/1)</TD><TD CLASS="h">0%   (0/9)</TD><TD CLASS="h">0%   (0/5)</TD></TR><TR><TD CLASS="f"><A HREF="#1b">getInTransitCouriers (): List</A></TD><TD> </TD><TD CLASS="h">0%   (0/1)</TD><TD CLASS="h">0%   (0/33)</TD><TD CLASS="h">0%   (0/6)</TD></TR><TR CLASS="o"><TD CLASS="f"><A HREF="#1c">getReleveantInfo (int []): Map</A></TD><TD> </TD><TD CLASS="h">0%   (0/1)</TD><TD CLASS="h">0%   (0/81)</TD><TD CLASS="h">0%   (0/14)</TD></TR><TR><TD CLASS="f"><A HREF="#1d">getRoute (String): List</A></TD><TD> </TD><TD CLASS="h">0%   (0/1)</TD><TD CLASS="h">0%   (0/11)</TD><TD CLASS="h">0%   (0/5)</TD></TR><TR CLASS="o"><TD CLASS="f"><A HREF="#1e">getSpecimen (String): Specimen</A></TD><TD> </TD><TD CLASS="h">0%   (0/1)</TD><TD CLASS="h">0%   (0/10)</TD><TD CLASS="h">0%   (0/5)</TD></TR><TR><TD CLASS="f"><A HREF="#1f">getStatus (int): Status</A></TD><TD> </TD><TD CLASS="h">0%   (0/1)</TD><TD CLASS="h">0%   (0/9)</TD><TD CLASS="h">0%   (0/4)</TD></TR><TR CLASS="o"><TD CLASS="f"><A HREF="#20">getUser (String): User</A></TD><TD> </TD><TD CLASS="h">0%   (0/1)</TD><TD CLASS="h">0%   (0/9)</TD><TD CLASS="h">0%   (0/4)</TD></TR><TR><TD CLASS="f"><A HREF="#21">getUserInfo (String, String): User</A></TD><TD> </TD><TD CLASS="h">0%   (0/1)</TD><TD CLASS="h">0%   (0/6)</TD><TD CLASS="h">0%   (0/2)</TD></TR><TR CLASS="o"><TD CLASS="f"><A HREF="#22">getUserType (String): UserType</A></TD><TD> </TD><TD CLASS="h">0%   (0/1)</TD><TD CLASS="h">0%   (0/10)</TD><TD CLASS="h">0%   (0/5)</TD></TR><TR><TD CLASS="f"><A HREF="#23">getUserType (int): UserType</A></TD><TD> </TD><TD CLASS="h">0%   (0/1)</TD><TD CLASS="h">0%   (0/9)</TD><TD CLASS="h">0%   (0/4)</TD></TR><TR CLASS="o"><TD CLASS="f"><A HREF="#24">pickedUp (String): boolean</A></TD><TD> </TD><TD CLASS="h">0%   (0/1)</TD><TD CLASS="h">0%   (0/34)</TD><TD CLASS="h">0%   (0/6)</TD></TR><TR><TD CLASS="f"><A HREF="#25">setServer (AndroidServer): void</A></TD><TD> </TD><TD CLASS="h">0%   (0/1)</TD><TD CLASS="h">0%   (0/11)</TD><TD CLASS="h">0%   (0/3)</TD></TR><TR CLASS="o"><TD CLASS="f"><A HREF="#26">specimenFrom (ClientSite): List</A></TD><TD> </TD><TD CLASS="h">0%   (0/1)</TD><TD CLASS="h">0%   (0/10)</TD><TD CLASS="h">0%   (0/5)</TD></TR><TR><TD CLASS="f"><A HREF="#27">specimensTo (ClientSite): List</A></TD><TD> </TD><TD CLASS="h">0%   (0/1)</TD><TD CLASS="h">0%   (0/10)</TD><TD CLASS="h">0%   (0/5)</TD></TR><TR CLASS="o"><TD CLASS="f"><A HREF="#28">updateGPS (String, double, double): void</A></TD><TD> </TD><TD CLASS="h">0%   (0/1)</TD><TD CLASS="h">0%   (0/39)</TD><TD CLASS="h">0%   (0/9)</TD></TR><TR><TD CLASS="f"><A HREF="#29">addShippingInformation (String, String, String, Map, String, int): boolean</A></TD><TD> </TD><TD>100% (1/1)</TD><TD CLASS="h">8%   (9/108)</TD><TD CLASS="h">13%  (2.7/21)</TD></TR><TR CLASS="o"><TD CLASS="f"><A HREF="#2a">getAllHospitals (): List</A></TD><TD> </TD><TD>100% (1/1)</TD><TD CLASS="h">33%  (4/12)</TD><TD CLASS="h">33%  (2/6)</TD></TR><TR><TD CLASS="f"><A HREF="#2b">noConnection (): void</A></TD><TD> </TD><TD>100% (1/1)</TD><TD CLASS="h">38%  (3/8)</TD><TD CLASS="h">67%  (2/3)</TD></TR><TR CLASS="o"><TD CLASS="f"><A HREF="#2c">getAllItems (): List</A></TD><TD> </TD><TD>100% (1/1)</TD><TD CLASS="h">44%  (4/9)</TD><TD CLASS="h">40%  (2/5)</TD></TR><TR><TD CLASS="f"><A HREF="#2d">getHospital (int): Hospital</A></TD><TD> </TD><TD>100% (1/1)</TD><TD CLASS="h">44%  (4/9)</TD><TD CLASS="h">25%  (1/4)</TD></TR><TR CLASS="o"><TD CLASS="f"><A HREF="#2e">getShippingInfo (String): ShippingInformation</A></TD><TD> </TD><TD>100% (1/1)</TD><TD CLASS="h">50%  (5/10)</TD><TD CLASS="h">40%  (2/5)</TD></TR><TR><TD CLASS="f"><A HREF="#2f">createConnection (String, String, String): boolean</A></TD><TD> </TD><TD>100% (1/1)</TD><TD CLASS="h">60%  (9/15)</TD><TD CLASS="h">40%  (2/5)</TD></TR><TR CLASS="o"><TD CLASS="f"><A HREF="#30">addHospital (String, String): boolean</A></TD><TD> </TD><TD>100% (1/1)</TD><TD CLASS="h">78%  (35/45)</TD><TD CLASS="h">50%  (4/8)</TD></TR><TR><TD CLASS="f"><A HREF="#31">addItemToSpecimen (String, String, String): boolean</A></TD><TD> </TD><TD>100% (1/1)</TD><TD>81%  (63/78)</TD><TD CLASS="h">65%  (11/17)</TD></TR><TR CLASS="o"><TD CLASS="f"><A HREF="#32">lengthChecker (String []): boolean</A></TD><TD> </TD><TD>100% (1/1)</TD><TD>88%  (15/17)</TD><TD CLASS="h">75%  (3/4)</TD></TR><TR><TD CLASS="f"><A HREF="#33">&lt;static initializer&gt;</A></TD><TD> </TD><TD>100% (1/1)</TD><TD>100% (7/7)</TD><TD>100% (3/3)</TD></TR></TABLE><P></P><TABLE CLASS="s" CELLSPACING="0" WIDTH="100%"><TR><TD CLASS="l">1</TD><TD>package jvm.jtacck.db;</TD></TR><TR><TD CLASS="l">2</TD><TD> </TD></TR><TR><TD CLASS="l">3</TD><TD>import java.util.Arrays;</TD></TR><TR><TD CLASS="l">4</TD><TD>import java.util.Collection;</TD></TR><TR><TD CLASS="l">5</TD><TD>import java.util.HashMap;</TD></TR><TR><TD CLASS="l">6</TD><TD>import java.util.LinkedList;</TD></TR><TR><TD CLASS="l">7</TD><TD>import java.util.List;</TD></TR><TR><TD CLASS="l">8</TD><TD>import java.util.Map;</TD></TR><TR><TD CLASS="l">9</TD><TD>import java.sql.SQLException;</TD></TR><TR><TD CLASS="l">10</TD><TD> </TD></TR><TR><TD CLASS="l">11</TD><TD>import jvm.jtacck.AndroidServer;</TD></TR><TR><TD CLASS="l">12</TD><TD>import jvm.jtacck.db.records.*;</TD></TR><TR><TD CLASS="l">13</TD><TD> </TD></TR><TR><TD CLASS="l">14</TD><TD>import static jvm.jtacck.Util.*;</TD></TR><TR><TD CLASS="l">15</TD><TD> </TD></TR><TR><TD CLASS="l">16</TD><TD>/**</TD></TR><TR><TD CLASS="l">17</TD><TD> * AwesomeCoreHandler(ACH) represents an interface over the PostgresHandler. The</TD></TR><TR><TD CLASS="l">18</TD><TD> * purpose of ACH is to provide a useful interface to the servers so that data</TD></TR><TR><TD CLASS="l">19</TD><TD> * can be sent as Strings and ints rather than the Record objects used by the</TD></TR><TR><TD CLASS="l">20</TD><TD> * PostgresHandler. This interface also provides, in addition to the general</TD></TR><TR><TD CLASS="l">21</TD><TD> * getters, more specific getters that have been specially tailored to the needs</TD></TR><TR><TD CLASS="l">22</TD><TD> * of the server.</TD></TR><TR><TD CLASS="l">23</TD><TD> * </TD></TR><TR><TD CLASS="l">24</TD><TD> * @author Andrew Lau</TD></TR><TR><TD CLASS="l"><A NAME="0">25</A></TD><TD> * </TD></TR><TR><TD CLASS="l">26</TD><TD> * @see jvm.jtacck.db.PostgresHandler</TD></TR><TR><TD CLASS="l">27</TD><TD> * </TD></TR><TR><TD CLASS="l"><A NAME="33">28</A></TD><TD> */</TD></TR><TR CLASS="p"><TD CLASS="l" TITLE="70% line coverage (7 out of 10 instructions)">29</TD><TD TITLE="70% line coverage (7 out of 10 instructions)">public final class AwesomeCoreHandler {</TD></TR><TR><TD CLASS="l">30</TD><TD> </TD></TR><TR><TD CLASS="l">31</TD><TD>    // TODO Document fields.</TD></TR><TR CLASS="c"><TD CLASS="l">32</TD><TD>    private final static List&lt;AndroidServer&gt; server = new LinkedList&lt;AndroidServer&gt;();</TD></TR><TR CLASS="c"><TD CLASS="l">33</TD><TD>    private static PostgresHandler dbConnection = null;</TD></TR><TR><TD CLASS="l">34</TD><TD>    private final static int FILLER = 1;</TD></TR><TR><TD CLASS="l">35</TD><TD> </TD></TR><TR><TD CLASS="l">36</TD><TD>    /**</TD></TR><TR><TD CLASS="l">37</TD><TD>     * Adds an Android Server to the current list of servers.</TD></TR><TR><TD CLASS="l">38</TD><TD>     * </TD></TR><TR><TD CLASS="l"><A NAME="25">39</A></TD><TD>     * @param serv</TD></TR><TR><TD CLASS="l">40</TD><TD>     *            - reference to an Android Server.</TD></TR><TR><TD CLASS="l">41</TD><TD>     */</TD></TR><TR><TD CLASS="l">42</TD><TD>    synchronized public static void setServer(AndroidServer serv) {</TD></TR><TR CLASS="z"><TD CLASS="l">43</TD><TD>        if (serv != null &amp;&amp; !server.contains(serv)) {</TD></TR><TR CLASS="z"><TD CLASS="l">44</TD><TD>            server.add(serv);</TD></TR><TR><TD CLASS="l">45</TD><TD>        }</TD></TR><TR CLASS="z"><TD CLASS="l">46</TD><TD>    }</TD></TR><TR><TD CLASS="l">47</TD><TD> </TD></TR><TR><TD CLASS="l">48</TD><TD>    /**</TD></TR><TR><TD CLASS="l">49</TD><TD>     * Attempts to create a new connection to the database with the given</TD></TR><TR><TD CLASS="l">50</TD><TD>     * username, password, and database address.</TD></TR><TR><TD CLASS="l">51</TD><TD>     * </TD></TR><TR><TD CLASS="l">52</TD><TD>     * @param username</TD></TR><TR><TD CLASS="l">53</TD><TD>     *            - username for the PostgresHandler</TD></TR><TR><TD CLASS="l">54</TD><TD>     * @param password</TD></TR><TR><TD CLASS="l">55</TD><TD>     *            - password that corresponds to the username.</TD></TR><TR><TD CLASS="l">56</TD><TD>     * @param dbAddress</TD></TR><TR><TD CLASS="l">57</TD><TD>     *            - address of the database. Must be of the format</TD></TR><TR><TD CLASS="l">58</TD><TD>     *            [server]:[port]/[databasename].</TD></TR><TR><TD CLASS="l">59</TD><TD>     * </TD></TR><TR><TD CLASS="l">60</TD><TD>     * @return Returns true if a connection to the database has been made.</TD></TR><TR><TD CLASS="l">61</TD><TD>     *         Otherwise, returns false.</TD></TR><TR><TD CLASS="l"><A NAME="2f">62</A></TD><TD>     */</TD></TR><TR><TD CLASS="l">63</TD><TD>    public static boolean createConnection(String username, String password,</TD></TR><TR><TD CLASS="l">64</TD><TD>            String dbAddress) {</TD></TR><TR><TD CLASS="l">65</TD><TD>        try {</TD></TR><TR CLASS="c"><TD CLASS="l">66</TD><TD>            dbConnection = new PostgresHandler(username, password, dbAddress);</TD></TR><TR CLASS="c"><TD CLASS="l">67</TD><TD>            return true;</TD></TR><TR CLASS="z"><TD CLASS="l">68</TD><TD>        } catch (SQLException e) {</TD></TR><TR CLASS="z"><TD CLASS="l">69</TD><TD>            logger.info(&#34;Connection to database couldn't be made&#34;);</TD></TR><TR CLASS="z"><TD CLASS="l">70</TD><TD>            return false;</TD></TR><TR><TD CLASS="l">71</TD><TD>        }</TD></TR><TR><TD CLASS="l">72</TD><TD>    }</TD></TR><TR><TD CLASS="l">73</TD><TD> </TD></TR><TR><TD CLASS="l">74</TD><TD>    /**</TD></TR><TR><TD CLASS="l">75</TD><TD>     * Attempts to close the connection with the database.</TD></TR><TR><TD CLASS="l">76</TD><TD>     * </TD></TR><TR><TD CLASS="l">77</TD><TD>     * @return Returns true if the connection to the database has been closed.</TD></TR><TR><TD CLASS="l">78</TD><TD>     *         Otherwise, returns false.</TD></TR><TR><TD CLASS="l">79</TD><TD>     * </TD></TR><TR><TD CLASS="l"><A NAME="c">80</A></TD><TD>     * @throws IllegalStateException</TD></TR><TR><TD CLASS="l">81</TD><TD>     *             if the there is no connection to the database</TD></TR><TR><TD CLASS="l">82</TD><TD>     */</TD></TR><TR><TD CLASS="l">83</TD><TD>    public static boolean closeConnection() throws IllegalStateException {</TD></TR><TR CLASS="z"><TD CLASS="l">84</TD><TD>        noConnection();</TD></TR><TR><TD CLASS="l">85</TD><TD>        try {</TD></TR><TR CLASS="z"><TD CLASS="l">86</TD><TD>            dbConnection.close();</TD></TR><TR CLASS="z"><TD CLASS="l">87</TD><TD>            return true;</TD></TR><TR CLASS="z"><TD CLASS="l">88</TD><TD>        } catch (SQLException e) {</TD></TR><TR CLASS="z"><TD CLASS="l">89</TD><TD>            logger.info(&#34;Connection to database already closed&#34;);</TD></TR><TR CLASS="z"><TD CLASS="l">90</TD><TD>            return false;</TD></TR><TR><TD CLASS="l">91</TD><TD>        }</TD></TR><TR><TD CLASS="l">92</TD><TD>    }</TD></TR><TR><TD CLASS="l">93</TD><TD> </TD></TR><TR><TD CLASS="l">94</TD><TD>    // ----------------------------------------------------------------------------</TD></TR><TR><TD CLASS="l">95</TD><TD>    // Methods that add to the database</TD></TR><TR><TD CLASS="l">96</TD><TD>    // ----------------------------------------------------------------------------</TD></TR><TR><TD CLASS="l">97</TD><TD> </TD></TR><TR><TD CLASS="l">98</TD><TD>    /**</TD></TR><TR><TD CLASS="l">99</TD><TD>     * Attempts to add a client site to the database.</TD></TR><TR><TD CLASS="l">100</TD><TD>     * </TD></TR><TR><TD CLASS="l">101</TD><TD>     * @param name</TD></TR><TR><TD CLASS="l">102</TD><TD>     *            - name of the client site</TD></TR><TR><TD CLASS="l">103</TD><TD>     * @param hospital</TD></TR><TR><TD CLASS="l">104</TD><TD>     *            - the id of hospital associated to the client site.</TD></TR><TR><TD CLASS="l">105</TD><TD>     * @param instructions</TD></TR><TR><TD CLASS="l">106</TD><TD>     *            - instructions of what to do at the client site. Intended for</TD></TR><TR><TD CLASS="l">107</TD><TD>     *            couriers</TD></TR><TR><TD CLASS="l">108</TD><TD>     * @param phone</TD></TR><TR><TD CLASS="l">109</TD><TD>     *            - phone number of the client site</TD></TR><TR><TD CLASS="l">110</TD><TD>     * </TD></TR><TR><TD CLASS="l">111</TD><TD>     * @returns Returns true if the addition to the database was successful.</TD></TR><TR><TD CLASS="l">112</TD><TD>     *          Otherwise, returns false.</TD></TR><TR><TD CLASS="l">113</TD><TD>     * </TD></TR><TR><TD CLASS="l">114</TD><TD>     * @throws IllegalStateException</TD></TR><TR><TD CLASS="l">115</TD><TD>     *             if the there is no connection to the database</TD></TR><TR><TD CLASS="l">116</TD><TD>     * @throws IllegalArgumentException</TD></TR><TR><TD CLASS="l">117</TD><TD>     *             if one of the parameters are invalid</TD></TR><TR><TD CLASS="l">118</TD><TD>     */</TD></TR><TR><TD CLASS="l"><A NAME="2">119</A></TD><TD>    public static boolean addClientSite(String name, int hospital_id,</TD></TR><TR><TD CLASS="l">120</TD><TD>            List&lt;String&gt; instructions, String phone)</TD></TR><TR><TD CLASS="l">121</TD><TD>            throws IllegalStateException, IllegalArgumentException {</TD></TR><TR><TD CLASS="l">122</TD><TD> </TD></TR><TR CLASS="z"><TD CLASS="l">123</TD><TD>        noConnection();</TD></TR><TR><TD CLASS="l">124</TD><TD> </TD></TR><TR CLASS="z"><TD CLASS="l">125</TD><TD>        Hospital hospital = getHospital(hospital_id);</TD></TR><TR><TD CLASS="l">126</TD><TD> </TD></TR><TR CLASS="z"><TD CLASS="l">127</TD><TD>        if (noNulls(hospital, instructions, phone, name) &amp;&amp; lengthChecker(name)) {</TD></TR><TR><TD CLASS="l">128</TD><TD>            try {</TD></TR><TR CLASS="z"><TD CLASS="l">129</TD><TD>                dbConnection.addRecord(new ClientSite(FILLER, name, hospital,</TD></TR><TR CLASS="z"><TD CLASS="l">130</TD><TD>                        instructions, phone));</TD></TR><TR CLASS="z"><TD CLASS="l">131</TD><TD>                return true;</TD></TR><TR CLASS="z"><TD CLASS="l">132</TD><TD>            } catch (SQLException e) {</TD></TR><TR CLASS="z"><TD CLASS="l">133</TD><TD>                e.printStackTrace();</TD></TR><TR CLASS="z"><TD CLASS="l">134</TD><TD>                return false;</TD></TR><TR><TD CLASS="l">135</TD><TD>            }</TD></TR><TR><TD CLASS="l">136</TD><TD>        } else {</TD></TR><TR CLASS="z"><TD CLASS="l">137</TD><TD>            throw new IllegalArgumentException(</TD></TR><TR CLASS="z"><TD CLASS="l">138</TD><TD>                    &#34;One or more arguments were null or name was too short&#34;);</TD></TR><TR><TD CLASS="l">139</TD><TD>        }</TD></TR><TR><TD CLASS="l">140</TD><TD>    }</TD></TR><TR><TD CLASS="l">141</TD><TD> </TD></TR><TR><TD CLASS="l">142</TD><TD>    /**</TD></TR><TR><TD CLASS="l">143</TD><TD>     * Attempts to add a courier to the database.</TD></TR><TR><TD CLASS="l">144</TD><TD>     * </TD></TR><TR><TD CLASS="l">145</TD><TD>     * @param username</TD></TR><TR><TD CLASS="l">146</TD><TD>     *            - the username of the user who is being assigned as a courier</TD></TR><TR><TD CLASS="l">147</TD><TD>     * @param password</TD></TR><TR><TD CLASS="l">148</TD><TD>     *            - the password assigned to the username</TD></TR><TR><TD CLASS="l">149</TD><TD>     * @param first</TD></TR><TR><TD CLASS="l">150</TD><TD>     *            - the first name of the person</TD></TR><TR><TD CLASS="l">151</TD><TD>     * @param last</TD></TR><TR><TD CLASS="l">152</TD><TD>     *            - the last name of the person</TD></TR><TR><TD CLASS="l">153</TD><TD>     * @param site_id</TD></TR><TR><TD CLASS="l">154</TD><TD>     *            - the id of the client site the person is assigned to</TD></TR><TR><TD CLASS="l">155</TD><TD>     * @param type_id</TD></TR><TR><TD CLASS="l">156</TD><TD>     *            - the id of the type the person is</TD></TR><TR><TD CLASS="l">157</TD><TD>     * @param client_id_route</TD></TR><TR><TD CLASS="l">158</TD><TD>     *            - the id of client sites of the route the courier is assigned</TD></TR><TR><TD CLASS="l">159</TD><TD>     *            to</TD></TR><TR><TD CLASS="l">160</TD><TD>     * @param lat</TD></TR><TR><TD CLASS="l">161</TD><TD>     *            - The latitude of the current user based on the Android GPS</TD></TR><TR><TD CLASS="l">162</TD><TD>     * @param longit</TD></TR><TR><TD CLASS="l">163</TD><TD>     *            - The longitude of the current user based on the Android GPS</TD></TR><TR><TD CLASS="l">164</TD><TD>     * </TD></TR><TR><TD CLASS="l">165</TD><TD>     * @returns Returns true if the addition to the database was successful.</TD></TR><TR><TD CLASS="l">166</TD><TD>     *          Otherwise, returns false.</TD></TR><TR><TD CLASS="l">167</TD><TD>     * </TD></TR><TR><TD CLASS="l">168</TD><TD>     * @throws IllegalStateException</TD></TR><TR><TD CLASS="l">169</TD><TD>     *             if the there is no connection to the database</TD></TR><TR><TD CLASS="l">170</TD><TD>     * @throws IllegalArgumentException</TD></TR><TR><TD CLASS="l">171</TD><TD>     *             if one of the parameters are invalid</TD></TR><TR><TD CLASS="l">172</TD><TD>     */</TD></TR><TR><TD CLASS="l">173</TD><TD>    public static boolean addCourier(String username, String password,</TD></TR><TR><TD CLASS="l"><A NAME="3">174</A></TD><TD>            String first, String last, int site_id, int type_id,</TD></TR><TR><TD CLASS="l">175</TD><TD>            List&lt;Integer&gt; client_id_route) throws IllegalStateException,</TD></TR><TR><TD CLASS="l">176</TD><TD>            IllegalArgumentException {</TD></TR><TR><TD CLASS="l">177</TD><TD> </TD></TR><TR CLASS="z"><TD CLASS="l">178</TD><TD>        noConnection();</TD></TR><TR><TD CLASS="l">179</TD><TD> </TD></TR><TR CLASS="z"><TD CLASS="l">180</TD><TD>        if (client_id_route != null &amp;&amp; username != null) {</TD></TR><TR><TD CLASS="l">181</TD><TD> </TD></TR><TR CLASS="z"><TD CLASS="l">182</TD><TD>            if (!addUser(username, password, first, last, site_id, type_id)</TD></TR><TR CLASS="z"><TD CLASS="l">183</TD><TD>                    &amp;&amp; getUser(username) == null) {</TD></TR><TR CLASS="z"><TD CLASS="l">184</TD><TD>                return false;</TD></TR><TR><TD CLASS="l">185</TD><TD>            }</TD></TR><TR><TD CLASS="l">186</TD><TD> </TD></TR><TR CLASS="z"><TD CLASS="l">187</TD><TD>            List&lt;ClientSite&gt; temp = new LinkedList&lt;ClientSite&gt;();</TD></TR><TR><TD CLASS="l">188</TD><TD> </TD></TR><TR CLASS="z"><TD CLASS="l">189</TD><TD>            for (Integer i : client_id_route) {</TD></TR><TR CLASS="z"><TD CLASS="l">190</TD><TD>                if (getClientSite(i) == null) {</TD></TR><TR CLASS="z"><TD CLASS="l">191</TD><TD>                    throw new IllegalArgumentException(&#34;Invalid destination &#34;</TD></TR><TR CLASS="z"><TD CLASS="l">192</TD><TD>                            + i);</TD></TR><TR><TD CLASS="l">193</TD><TD>                }</TD></TR><TR CLASS="z"><TD CLASS="l">194</TD><TD>                temp.add(getClientSite(i));</TD></TR><TR><TD CLASS="l">195</TD><TD>            }</TD></TR><TR><TD CLASS="l">196</TD><TD> </TD></TR><TR><TD CLASS="l">197</TD><TD>            try {</TD></TR><TR CLASS="z"><TD CLASS="l">198</TD><TD>                dbConnection.addRecord(new Courier(new User(username, password,</TD></TR><TR CLASS="z"><TD CLASS="l">199</TD><TD>                        first, last, getClientSite(site_id),</TD></TR><TR CLASS="z"><TD CLASS="l">200</TD><TD>                        getUserType(type_id)), temp, 0, 0,</TD></TR><TR CLASS="z"><TD CLASS="l">201</TD><TD>                        temp.size() == 0 ? null : temp.get(0)));</TD></TR><TR CLASS="z"><TD CLASS="l">202</TD><TD>                return true;</TD></TR><TR CLASS="z"><TD CLASS="l">203</TD><TD>            } catch (SQLException e) {</TD></TR><TR CLASS="z"><TD CLASS="l">204</TD><TD>                e.printStackTrace();</TD></TR><TR CLASS="z"><TD CLASS="l">205</TD><TD>                return false;</TD></TR><TR><TD CLASS="l">206</TD><TD>            }</TD></TR><TR><TD CLASS="l">207</TD><TD>        } else {</TD></TR><TR CLASS="z"><TD CLASS="l">208</TD><TD>            throw new IllegalArgumentException(&#34;Route or username is null.&#34;);</TD></TR><TR><TD CLASS="l">209</TD><TD>        }</TD></TR><TR><TD CLASS="l">210</TD><TD>    }</TD></TR><TR><TD CLASS="l">211</TD><TD> </TD></TR><TR><TD CLASS="l">212</TD><TD>    /**</TD></TR><TR><TD CLASS="l">213</TD><TD>     * Attempts to add a hospital to the database.</TD></TR><TR><TD CLASS="l">214</TD><TD>     * </TD></TR><TR><TD CLASS="l">215</TD><TD>     * @param name</TD></TR><TR><TD CLASS="l">216</TD><TD>     *            - name of the hospital</TD></TR><TR><TD CLASS="l">217</TD><TD>     * @param address</TD></TR><TR><TD CLASS="l">218</TD><TD>     *            - address of the hospital in the form: [Address 1], [Address</TD></TR><TR><TD CLASS="l">219</TD><TD>     *            2], [City], [State], [ZipCode]</TD></TR><TR><TD CLASS="l">220</TD><TD>     * </TD></TR><TR><TD CLASS="l">221</TD><TD>     * @returns Returns true if the addition to the database was successful.</TD></TR><TR><TD CLASS="l">222</TD><TD>     *          Otherwise, returns false.</TD></TR><TR><TD CLASS="l">223</TD><TD>     * </TD></TR><TR><TD CLASS="l">224</TD><TD>     * @throws IllegalStateException</TD></TR><TR><TD CLASS="l">225</TD><TD>     *             if the there is no connection to the database</TD></TR><TR><TD CLASS="l">226</TD><TD>     * @throws IllegalArgumentException</TD></TR><TR><TD CLASS="l">227</TD><TD>     *             if the parameters are invalid</TD></TR><TR><TD CLASS="l"><A NAME="30">228</A></TD><TD>     */</TD></TR><TR><TD CLASS="l">229</TD><TD>    public static boolean addHospital(String name, String address)</TD></TR><TR><TD CLASS="l">230</TD><TD>            throws IllegalStateException, IllegalArgumentException {</TD></TR><TR><TD CLASS="l">231</TD><TD> </TD></TR><TR CLASS="c"><TD CLASS="l">232</TD><TD>        noConnection();</TD></TR><TR><TD CLASS="l">233</TD><TD> </TD></TR><TR CLASS="c"><TD CLASS="l">234</TD><TD>        if (noNulls(name, address) &amp;&amp; lengthChecker(name, address)) {</TD></TR><TR><TD CLASS="l">235</TD><TD>            try {</TD></TR><TR CLASS="c"><TD CLASS="l">236</TD><TD>                dbConnection.addRecord(new Hospital(FILLER, name, address));</TD></TR><TR CLASS="c"><TD CLASS="l">237</TD><TD>                return true;</TD></TR><TR CLASS="z"><TD CLASS="l">238</TD><TD>            } catch (SQLException e) {</TD></TR><TR CLASS="z"><TD CLASS="l">239</TD><TD>                e.printStackTrace();</TD></TR><TR CLASS="z"><TD CLASS="l">240</TD><TD>                return false;</TD></TR><TR><TD CLASS="l">241</TD><TD>            }</TD></TR><TR><TD CLASS="l">242</TD><TD>        } else {</TD></TR><TR CLASS="z"><TD CLASS="l">243</TD><TD>            throw new IllegalArgumentException(&#34;Name or address is invalid&#34;);</TD></TR><TR><TD CLASS="l">244</TD><TD>        }</TD></TR><TR><TD CLASS="l">245</TD><TD>    }</TD></TR><TR><TD CLASS="l">246</TD><TD> </TD></TR><TR><TD CLASS="l">247</TD><TD>    /**</TD></TR><TR><TD CLASS="l">248</TD><TD>     * Attempts to add shipping information to the database.</TD></TR><TR><TD CLASS="l">249</TD><TD>     * </TD></TR><TR><TD CLASS="l">250</TD><TD>     * @param barcode</TD></TR><TR><TD CLASS="l">251</TD><TD>     *            - a barcode used to identify the specimen</TD></TR><TR><TD CLASS="l">252</TD><TD>     * @param reqs</TD></TR><TR><TD CLASS="l">253</TD><TD>     *            - any requirements associated to the specimen</TD></TR><TR><TD CLASS="l">254</TD><TD>     * @param instructions</TD></TR><TR><TD CLASS="l">255</TD><TD>     *            - any instructions needed for the specimen</TD></TR><TR><TD CLASS="l">256</TD><TD>     * @param items</TD></TR><TR><TD CLASS="l">257</TD><TD>     *            - a collection of items within the specimen package</TD></TR><TR><TD CLASS="l">258</TD><TD>     * @param username</TD></TR><TR><TD CLASS="l">259</TD><TD>     *            - the username of the person adding the specimen info</TD></TR><TR><TD CLASS="l">260</TD><TD>     * @param dest</TD></TR><TR><TD CLASS="l">261</TD><TD>     *            - an id representing a client site destination</TD></TR><TR><TD CLASS="l">262</TD><TD>     * @param status</TD></TR><TR><TD CLASS="l">263</TD><TD>     *            - an id representing a status type</TD></TR><TR><TD CLASS="l">264</TD><TD>     * </TD></TR><TR><TD CLASS="l">265</TD><TD>     * @returns Returns true if the addition to the database was successful.</TD></TR><TR><TD CLASS="l">266</TD><TD>     *          Otherwise, returns false.</TD></TR><TR><TD CLASS="l">267</TD><TD>     * </TD></TR><TR><TD CLASS="l">268</TD><TD>     * @throws IllegalStateException</TD></TR><TR><TD CLASS="l">269</TD><TD>     *             if the there is no connection to the database</TD></TR><TR><TD CLASS="l">270</TD><TD>     * @throws IllegalArgumentException</TD></TR><TR><TD CLASS="l">271</TD><TD>     *             if there is an invalid argument</TD></TR><TR><TD CLASS="l">272</TD><TD>     */</TD></TR><TR><TD CLASS="l"><A NAME="29">273</A></TD><TD>    public static boolean addShippingInformation(String barcode, String desc,</TD></TR><TR><TD CLASS="l">274</TD><TD>            String reqs, Map&lt;String, String&gt; items, String username, int dest)</TD></TR><TR><TD CLASS="l">275</TD><TD>            throws IllegalStateException, IllegalArgumentException {</TD></TR><TR><TD CLASS="l">276</TD><TD> </TD></TR><TR CLASS="c"><TD CLASS="l">277</TD><TD>        noConnection();</TD></TR><TR><TD CLASS="l">278</TD><TD> </TD></TR><TR CLASS="p"><TD CLASS="l" TITLE="67% line coverage (4 out of 6 instructions)">279</TD><TD TITLE="67% line coverage (4 out of 6 instructions)">        if (getShippingInfo(barcode) != null || items == null) {</TD></TR><TR CLASS="c"><TD CLASS="l">280</TD><TD>            throw new IllegalArgumentException(&#34;Duplicate barcode exists&#34;</TD></TR><TR><TD CLASS="l">281</TD><TD>                    + &#34; or null items&#34;);</TD></TR><TR><TD CLASS="l">282</TD><TD>        }</TD></TR><TR><TD CLASS="l">283</TD><TD> </TD></TR><TR CLASS="z"><TD CLASS="l">284</TD><TD>        Collection&lt;Item&gt; actualItems = new LinkedList&lt;Item&gt;();</TD></TR><TR><TD CLASS="l">285</TD><TD> </TD></TR><TR CLASS="z"><TD CLASS="l">286</TD><TD>        if (items.size() &gt; 0) {</TD></TR><TR CLASS="z"><TD CLASS="l">287</TD><TD>            for (String s : items.keySet()) {</TD></TR><TR CLASS="z"><TD CLASS="l">288</TD><TD>                actualItems.add(new Item(FILLER, s, items.get(s)));</TD></TR><TR><TD CLASS="l">289</TD><TD>            }</TD></TR><TR><TD CLASS="l">290</TD><TD>        }</TD></TR><TR><TD CLASS="l">291</TD><TD> </TD></TR><TR CLASS="z"><TD CLASS="l">292</TD><TD>        if (noNulls(reqs, desc, username, getUser(username),</TD></TR><TR CLASS="z"><TD CLASS="l">293</TD><TD>                getClientSite(dest))</TD></TR><TR CLASS="z"><TD CLASS="l">294</TD><TD>                &amp;&amp; barcode.length() &gt; 0</TD></TR><TR CLASS="z"><TD CLASS="l">295</TD><TD>                &amp;&amp; actualItems.size() &gt; 0) {</TD></TR><TR><TD CLASS="l">296</TD><TD>            try {</TD></TR><TR CLASS="z"><TD CLASS="l">297</TD><TD>                Specimen s_temp = new Specimen(barcode, desc, reqs, actualItems);</TD></TR><TR CLASS="z"><TD CLASS="l">298</TD><TD>                dbConnection.addRecord(new ShippingInformation(s_temp,</TD></TR><TR CLASS="z"><TD CLASS="l">299</TD><TD>                        getUser(username), getClientSite(dest), getStatus(1),</TD></TR><TR CLASS="z"><TD CLASS="l">300</TD><TD>                        getCourierInfo(&#34;jjeng&#34;)));</TD></TR><TR><TD CLASS="l">301</TD><TD>                // null));</TD></TR><TR CLASS="z"><TD CLASS="l">302</TD><TD>                return true;</TD></TR><TR CLASS="z"><TD CLASS="l">303</TD><TD>            } catch (SQLException e) {</TD></TR><TR CLASS="z"><TD CLASS="l">304</TD><TD>                e.printStackTrace();</TD></TR><TR CLASS="z"><TD CLASS="l">305</TD><TD>                return false;</TD></TR><TR><TD CLASS="l">306</TD><TD>            }</TD></TR><TR><TD CLASS="l">307</TD><TD>        } else {</TD></TR><TR CLASS="z"><TD CLASS="l">308</TD><TD>            throw new IllegalArgumentException(</TD></TR><TR CLASS="z"><TD CLASS="l">309</TD><TD>                    &#34;Null strings detected, ivalid username/destination or &#34;</TD></TR><TR><TD CLASS="l">310</TD><TD>                            + &#34;barcode is less than 1.&#34;);</TD></TR><TR><TD CLASS="l">311</TD><TD>        }</TD></TR><TR><TD CLASS="l">312</TD><TD>    }</TD></TR><TR><TD CLASS="l">313</TD><TD> </TD></TR><TR><TD CLASS="l">314</TD><TD>    /**</TD></TR><TR><TD CLASS="l">315</TD><TD>     * Attempts to add a user to the database.</TD></TR><TR><TD CLASS="l">316</TD><TD>     * </TD></TR><TR><TD CLASS="l">317</TD><TD>     * @param username</TD></TR><TR><TD CLASS="l">318</TD><TD>     *            - The username of the person being added</TD></TR><TR><TD CLASS="l">319</TD><TD>     * @param password</TD></TR><TR><TD CLASS="l">320</TD><TD>     *            - The password associated to the username</TD></TR><TR><TD CLASS="l">321</TD><TD>     * @param first</TD></TR><TR><TD CLASS="l">322</TD><TD>     *            - The first name of the person</TD></TR><TR><TD CLASS="l">323</TD><TD>     * @param last</TD></TR><TR><TD CLASS="l">324</TD><TD>     *            - The last name of the person</TD></TR><TR><TD CLASS="l">325</TD><TD>     * @param site_id</TD></TR><TR><TD CLASS="l">326</TD><TD>     *            - A client site that the person is assigned to</TD></TR><TR><TD CLASS="l">327</TD><TD>     * @param type_id</TD></TR><TR><TD CLASS="l">328</TD><TD>     *            - A user type regarding the person's privileges</TD></TR><TR><TD CLASS="l">329</TD><TD>     * </TD></TR><TR><TD CLASS="l">330</TD><TD>     * @returns Returns true if the addition to the database was successful.</TD></TR><TR><TD CLASS="l">331</TD><TD>     *          Otherwise, returns false.</TD></TR><TR><TD CLASS="l">332</TD><TD>     * </TD></TR><TR><TD CLASS="l">333</TD><TD>     * @throws IllegalStateException</TD></TR><TR><TD CLASS="l">334</TD><TD>     *             if the there is no connection to the database</TD></TR><TR><TD CLASS="l">335</TD><TD>     * @throws IllegalArgumentException</TD></TR><TR><TD CLASS="l">336</TD><TD>     *             if the arguments are not valid such as being null</TD></TR><TR><TD CLASS="l">337</TD><TD>     */</TD></TR><TR><TD CLASS="l"><A NAME="4">338</A></TD><TD>    public static boolean addUser(String username, String password,</TD></TR><TR><TD CLASS="l">339</TD><TD>            String first, String last, int site_id, int type_id)</TD></TR><TR><TD CLASS="l">340</TD><TD>            throws IllegalStateException, IllegalArgumentException {</TD></TR><TR><TD CLASS="l">341</TD><TD> </TD></TR><TR CLASS="z"><TD CLASS="l">342</TD><TD>        noConnection();</TD></TR><TR><TD CLASS="l">343</TD><TD> </TD></TR><TR CLASS="z"><TD CLASS="l">344</TD><TD>        ClientSite cs = getClientSite(site_id);</TD></TR><TR CLASS="z"><TD CLASS="l">345</TD><TD>        UserType type = getUserType(type_id);</TD></TR><TR><TD CLASS="l">346</TD><TD> </TD></TR><TR CLASS="z"><TD CLASS="l">347</TD><TD>        if (noNulls(username, password, first, last, cs, type)</TD></TR><TR CLASS="z"><TD CLASS="l">348</TD><TD>                &amp;&amp; lengthChecker(username, password, first, last)) {</TD></TR><TR><TD CLASS="l">349</TD><TD> </TD></TR><TR CLASS="z"><TD CLASS="l">350</TD><TD>            if (getUser(username) != null) {</TD></TR><TR CLASS="z"><TD CLASS="l">351</TD><TD>                return false;</TD></TR><TR><TD CLASS="l">352</TD><TD>            }</TD></TR><TR><TD CLASS="l">353</TD><TD> </TD></TR><TR><TD CLASS="l">354</TD><TD>            try {</TD></TR><TR CLASS="z"><TD CLASS="l">355</TD><TD>                dbConnection.addRecord(new User(username, password, first,</TD></TR><TR CLASS="z"><TD CLASS="l">356</TD><TD>                        last, cs, type));</TD></TR><TR CLASS="z"><TD CLASS="l">357</TD><TD>                return true;</TD></TR><TR CLASS="z"><TD CLASS="l">358</TD><TD>            } catch (SQLException e) {</TD></TR><TR CLASS="z"><TD CLASS="l">359</TD><TD>                e.printStackTrace();</TD></TR><TR CLASS="z"><TD CLASS="l">360</TD><TD>                return false;</TD></TR><TR><TD CLASS="l">361</TD><TD>            }</TD></TR><TR><TD CLASS="l">362</TD><TD>        } else {</TD></TR><TR CLASS="z"><TD CLASS="l">363</TD><TD>            throw new IllegalArgumentException(&#34;One or more of the parameters&#34;</TD></TR><TR><TD CLASS="l">364</TD><TD>                    + &#34; are invalid. Input must not be empty.&#34;);</TD></TR><TR><TD CLASS="l">365</TD><TD>        }</TD></TR><TR><TD CLASS="l">366</TD><TD> </TD></TR><TR><TD CLASS="l">367</TD><TD>    }</TD></TR><TR><TD CLASS="l">368</TD><TD> </TD></TR><TR><TD CLASS="l">369</TD><TD>    /**</TD></TR><TR><TD CLASS="l">370</TD><TD>     * Adds an item to the given specimen. Use this to add a item to the</TD></TR><TR><TD CLASS="l">371</TD><TD>     * existing item collection of a specimen.</TD></TR><TR><TD CLASS="l">372</TD><TD>     * </TD></TR><TR><TD CLASS="l">373</TD><TD>     * @param barcode</TD></TR><TR><TD CLASS="l">374</TD><TD>     *            - barcode of the specimen</TD></TR><TR><TD CLASS="l">375</TD><TD>     * @param name</TD></TR><TR><TD CLASS="l">376</TD><TD>     *            - name of the item</TD></TR><TR><TD CLASS="l">377</TD><TD>     * @param color</TD></TR><TR><TD CLASS="l">378</TD><TD>     *            - color of the item (or its cap)</TD></TR><TR><TD CLASS="l">379</TD><TD>     * </TD></TR><TR><TD CLASS="l">380</TD><TD>     * @return Returns true if the modification to the database was successful.</TD></TR><TR><TD CLASS="l">381</TD><TD>     *         Otherwise, returns false.</TD></TR><TR><TD CLASS="l">382</TD><TD>     * </TD></TR><TR><TD CLASS="l">383</TD><TD>     * @throws IllegalStateException</TD></TR><TR><TD CLASS="l">384</TD><TD>     *             if the there is no connection to the database</TD></TR><TR><TD CLASS="l">385</TD><TD>     * @throws IllegalArgumentException</TD></TR><TR><TD CLASS="l">386</TD><TD>     *             if there is an invalid argument</TD></TR><TR><TD CLASS="l"><A NAME="31">387</A></TD><TD>     */</TD></TR><TR><TD CLASS="l">388</TD><TD>    public static boolean addItemToSpecimen(String barcode, String name,</TD></TR><TR><TD CLASS="l">389</TD><TD>            String color) throws IllegalStateException,</TD></TR><TR><TD CLASS="l">390</TD><TD>            IllegalArgumentException {</TD></TR><TR CLASS="c"><TD CLASS="l">391</TD><TD>        noConnection();</TD></TR><TR CLASS="c"><TD CLASS="l">392</TD><TD>        if (getShippingInfo(barcode) == null) {</TD></TR><TR CLASS="z"><TD CLASS="l">393</TD><TD>            throw new IllegalArgumentException(&#34;Invalid barcode&#34;);</TD></TR><TR><TD CLASS="l">394</TD><TD>        }</TD></TR><TR CLASS="c"><TD CLASS="l">395</TD><TD>        if (noNulls(name, color) &amp;&amp; lengthChecker(name, color)</TD></TR><TR CLASS="c"><TD CLASS="l">396</TD><TD>                &amp;&amp; barcode.length() &gt; 0) {</TD></TR><TR><TD CLASS="l">397</TD><TD>            try {</TD></TR><TR CLASS="c"><TD CLASS="l">398</TD><TD>                Specimen old = dbConnection.getSpecimenByID(barcode);</TD></TR><TR CLASS="c"><TD CLASS="l">399</TD><TD>                Collection&lt;Item&gt; temp = old.contents;</TD></TR><TR CLASS="c"><TD CLASS="l">400</TD><TD>                temp.add(new Item(FILLER, name, color));</TD></TR><TR CLASS="c"><TD CLASS="l">401</TD><TD>                Specimen replace = new Specimen(old.barcode, old.description,</TD></TR><TR CLASS="c"><TD CLASS="l">402</TD><TD>                        old.requirements, temp);</TD></TR><TR CLASS="c"><TD CLASS="l">403</TD><TD>                dbConnection.changeRecord(replace);</TD></TR><TR CLASS="c"><TD CLASS="l">404</TD><TD>                return true;</TD></TR><TR CLASS="z"><TD CLASS="l">405</TD><TD>            } catch (SQLException e) {</TD></TR><TR CLASS="z"><TD CLASS="l">406</TD><TD>                e.printStackTrace();</TD></TR><TR CLASS="z"><TD CLASS="l">407</TD><TD>                return false;</TD></TR><TR><TD CLASS="l">408</TD><TD>            }</TD></TR><TR><TD CLASS="l">409</TD><TD>        } else {</TD></TR><TR CLASS="z"><TD CLASS="l">410</TD><TD>            throw new IllegalArgumentException(</TD></TR><TR CLASS="z"><TD CLASS="l">411</TD><TD>                    &#34;Name or color is invalid or barcode is less than 0.&#34;);</TD></TR><TR><TD CLASS="l">412</TD><TD>        }</TD></TR><TR><TD CLASS="l">413</TD><TD>    }</TD></TR><TR><TD CLASS="l">414</TD><TD> </TD></TR><TR><TD CLASS="l">415</TD><TD>    // ----------------------------------------------------------------------------</TD></TR><TR><TD CLASS="l">416</TD><TD>    // Methods that modify items in the database</TD></TR><TR><TD CLASS="l">417</TD><TD>    // ----------------------------------------------------------------------------</TD></TR><TR><TD CLASS="l">418</TD><TD> </TD></TR><TR><TD CLASS="l">419</TD><TD>    /**</TD></TR><TR><TD CLASS="l">420</TD><TD>     * Attempts to modify a client site to the database.</TD></TR><TR><TD CLASS="l">421</TD><TD>     * </TD></TR><TR><TD CLASS="l">422</TD><TD>     * @param name</TD></TR><TR><TD CLASS="l">423</TD><TD>     *            - name of the client site</TD></TR><TR><TD CLASS="l">424</TD><TD>     * @param hospital_id</TD></TR><TR><TD CLASS="l">425</TD><TD>     *            - the id of hospital associated to the client site. SHOULD NOT</TD></TR><TR><TD CLASS="l">426</TD><TD>     *            BE MODIFIABLE BY END USER.</TD></TR><TR><TD CLASS="l">427</TD><TD>     * @param instructions</TD></TR><TR><TD CLASS="l">428</TD><TD>     *            - instructions of what to do at the client site. Intended for</TD></TR><TR><TD CLASS="l">429</TD><TD>     *            couriers</TD></TR><TR><TD CLASS="l">430</TD><TD>     * @param phone</TD></TR><TR><TD CLASS="l">431</TD><TD>     *            - phone number of the client site</TD></TR><TR><TD CLASS="l">432</TD><TD>     * </TD></TR><TR><TD CLASS="l">433</TD><TD>     * @returns Returns true if the modification to the database was successful.</TD></TR><TR><TD CLASS="l">434</TD><TD>     *          Otherwise, returns false.</TD></TR><TR><TD CLASS="l">435</TD><TD>     * </TD></TR><TR><TD CLASS="l">436</TD><TD>     * @throws IllegalStateException</TD></TR><TR><TD CLASS="l">437</TD><TD>     *             if the there is no connection to the database</TD></TR><TR><TD CLASS="l">438</TD><TD>     * @throws IllegalArgumentException</TD></TR><TR><TD CLASS="l">439</TD><TD>     *             if one of the parameters are invalid</TD></TR><TR><TD CLASS="l">440</TD><TD>     */</TD></TR><TR><TD CLASS="l"><A NAME="5">441</A></TD><TD>    public static boolean changeClientSite(String name, int hospital_id,</TD></TR><TR><TD CLASS="l">442</TD><TD>            List&lt;String&gt; instructions, String phone)</TD></TR><TR><TD CLASS="l">443</TD><TD>            throws IllegalStateException, IllegalArgumentException {</TD></TR><TR><TD CLASS="l">444</TD><TD> </TD></TR><TR CLASS="z"><TD CLASS="l">445</TD><TD>        noConnection();</TD></TR><TR><TD CLASS="l">446</TD><TD> </TD></TR><TR CLASS="z"><TD CLASS="l">447</TD><TD>        Hospital hospital = getHospital(hospital_id);</TD></TR><TR><TD CLASS="l">448</TD><TD> </TD></TR><TR CLASS="z"><TD CLASS="l">449</TD><TD>        if (noNulls(hospital, instructions, phone, name) &amp;&amp; lengthChecker(name)) {</TD></TR><TR><TD CLASS="l">450</TD><TD>            try {</TD></TR><TR CLASS="z"><TD CLASS="l">451</TD><TD>                dbConnection.changeRecord(new ClientSite(FILLER, name,</TD></TR><TR CLASS="z"><TD CLASS="l">452</TD><TD>                        hospital, instructions, phone));</TD></TR><TR CLASS="z"><TD CLASS="l">453</TD><TD>                return true;</TD></TR><TR CLASS="z"><TD CLASS="l">454</TD><TD>            } catch (SQLException e) {</TD></TR><TR CLASS="z"><TD CLASS="l">455</TD><TD>                e.printStackTrace();</TD></TR><TR CLASS="z"><TD CLASS="l">456</TD><TD>                return false;</TD></TR><TR><TD CLASS="l">457</TD><TD>            }</TD></TR><TR><TD CLASS="l">458</TD><TD>        } else {</TD></TR><TR CLASS="z"><TD CLASS="l">459</TD><TD>            throw new IllegalArgumentException(</TD></TR><TR CLASS="z"><TD CLASS="l">460</TD><TD>                    &#34;One or more arguments were null or name was too short&#34;);</TD></TR><TR><TD CLASS="l">461</TD><TD>        }</TD></TR><TR><TD CLASS="l">462</TD><TD>    }</TD></TR><TR><TD CLASS="l">463</TD><TD> </TD></TR><TR><TD CLASS="l">464</TD><TD>    /**</TD></TR><TR><TD CLASS="l">465</TD><TD>     * Attempts to modify a courier to the database.</TD></TR><TR><TD CLASS="l">466</TD><TD>     * </TD></TR><TR><TD CLASS="l">467</TD><TD>     * @param username</TD></TR><TR><TD CLASS="l">468</TD><TD>     *            - the username of the user who is being assigned as a courier.</TD></TR><TR><TD CLASS="l">469</TD><TD>     *            THIS SHOULD NOT BE MODIFIABLE BY END USER.</TD></TR><TR><TD CLASS="l">470</TD><TD>     * @param password</TD></TR><TR><TD CLASS="l">471</TD><TD>     *            - the password assigned to the username</TD></TR><TR><TD CLASS="l">472</TD><TD>     * @param first</TD></TR><TR><TD CLASS="l">473</TD><TD>     *            - the first name of the person</TD></TR><TR><TD CLASS="l">474</TD><TD>     * @param last</TD></TR><TR><TD CLASS="l">475</TD><TD>     *            - the last name of the person</TD></TR><TR><TD CLASS="l">476</TD><TD>     * @param site_id</TD></TR><TR><TD CLASS="l">477</TD><TD>     *            - the id of the client site the person is assigned to</TD></TR><TR><TD CLASS="l">478</TD><TD>     * @param type_id</TD></TR><TR><TD CLASS="l">479</TD><TD>     *            - the id of the type the person is</TD></TR><TR><TD CLASS="l">480</TD><TD>     * @param client_id_route</TD></TR><TR><TD CLASS="l">481</TD><TD>     *            - the id of client sites of the route the courier is assigned</TD></TR><TR><TD CLASS="l">482</TD><TD>     *            to</TD></TR><TR><TD CLASS="l">483</TD><TD>     * @param lat</TD></TR><TR><TD CLASS="l">484</TD><TD>     *            - The latitude of the current user based on the Android GPS</TD></TR><TR><TD CLASS="l">485</TD><TD>     * @param longit</TD></TR><TR><TD CLASS="l">486</TD><TD>     *            - The longitude of the current user based on the Android GPS</TD></TR><TR><TD CLASS="l">487</TD><TD>     * </TD></TR><TR><TD CLASS="l">488</TD><TD>     * @returns Returns true if the modification to the database was successful.</TD></TR><TR><TD CLASS="l">489</TD><TD>     *          Otherwise, returns false.</TD></TR><TR><TD CLASS="l">490</TD><TD>     * </TD></TR><TR><TD CLASS="l">491</TD><TD>     * @throws IllegalStateException</TD></TR><TR><TD CLASS="l">492</TD><TD>     *             if the there is no connection to the database</TD></TR><TR><TD CLASS="l">493</TD><TD>     * @throws IllegalArgumentException</TD></TR><TR><TD CLASS="l">494</TD><TD>     *             if one of the parameters are invalid</TD></TR><TR><TD CLASS="l">495</TD><TD>     */</TD></TR><TR><TD CLASS="l">496</TD><TD>    public static boolean changeCourier(String username, String password,</TD></TR><TR><TD CLASS="l"><A NAME="6">497</A></TD><TD>            String first, String last, int site_id, int type_id,</TD></TR><TR><TD CLASS="l">498</TD><TD>            List&lt;Integer&gt; client_id_route) throws IllegalStateException,</TD></TR><TR><TD CLASS="l">499</TD><TD>            IllegalArgumentException {</TD></TR><TR><TD CLASS="l">500</TD><TD> </TD></TR><TR CLASS="z"><TD CLASS="l">501</TD><TD>        noConnection();</TD></TR><TR><TD CLASS="l">502</TD><TD> </TD></TR><TR CLASS="z"><TD CLASS="l">503</TD><TD>        if (noNulls(username, password, first, last, client_id_route,</TD></TR><TR CLASS="z"><TD CLASS="l">504</TD><TD>                getUser(username), getCourierInfo(username))</TD></TR><TR CLASS="z"><TD CLASS="l">505</TD><TD>                &amp;&amp; lengthChecker(username, password, first, last)) {</TD></TR><TR><TD CLASS="l">506</TD><TD> </TD></TR><TR CLASS="z"><TD CLASS="l">507</TD><TD>            List&lt;ClientSite&gt; temp = new LinkedList&lt;ClientSite&gt;();</TD></TR><TR><TD CLASS="l">508</TD><TD> </TD></TR><TR CLASS="z"><TD CLASS="l">509</TD><TD>            for (Integer i : client_id_route) {</TD></TR><TR CLASS="z"><TD CLASS="l">510</TD><TD>                if (getClientSite(i) == null) {</TD></TR><TR CLASS="z"><TD CLASS="l">511</TD><TD>                    throw new IllegalArgumentException(&#34;Invalid destination &#34;</TD></TR><TR CLASS="z"><TD CLASS="l">512</TD><TD>                            + i);</TD></TR><TR><TD CLASS="l">513</TD><TD>                }</TD></TR><TR CLASS="z"><TD CLASS="l">514</TD><TD>                temp.add(getClientSite(i));</TD></TR><TR><TD CLASS="l">515</TD><TD>            }</TD></TR><TR><TD CLASS="l">516</TD><TD> </TD></TR><TR CLASS="z"><TD CLASS="l">517</TD><TD>            Courier old = getCourierInfo(username);</TD></TR><TR CLASS="z"><TD CLASS="l">518</TD><TD>            ClientSite cs = null;</TD></TR><TR CLASS="z"><TD CLASS="l">519</TD><TD>            if ((old.nextDest == null || !temp.contains(old.nextDest))</TD></TR><TR CLASS="z"><TD CLASS="l">520</TD><TD>                    &amp;&amp; temp.size() &gt;= 1) {</TD></TR><TR CLASS="z"><TD CLASS="l">521</TD><TD>                cs = temp.get(0);</TD></TR><TR CLASS="z"><TD CLASS="l">522</TD><TD>            } else if (temp.contains(old.nextDest)) {</TD></TR><TR CLASS="z"><TD CLASS="l">523</TD><TD>                cs = old.nextDest;</TD></TR><TR><TD CLASS="l">524</TD><TD>            }</TD></TR><TR><TD CLASS="l">525</TD><TD> </TD></TR><TR><TD CLASS="l">526</TD><TD>            try {</TD></TR><TR CLASS="z"><TD CLASS="l">527</TD><TD>                dbConnection.changeRecord(new Courier(new User(username,</TD></TR><TR CLASS="z"><TD CLASS="l">528</TD><TD>                        password, first, last, getClientSite(site_id),</TD></TR><TR CLASS="z"><TD CLASS="l">529</TD><TD>                        getUserType(type_id)), temp, old.latitude,</TD></TR><TR CLASS="z"><TD CLASS="l">530</TD><TD>                        old.longitude, cs));</TD></TR><TR CLASS="z"><TD CLASS="l">531</TD><TD>                server.get(0).pushRoute(username, temp);</TD></TR><TR CLASS="z"><TD CLASS="l">532</TD><TD>                return true;</TD></TR><TR CLASS="z"><TD CLASS="l">533</TD><TD>            } catch (SQLException e) {</TD></TR><TR CLASS="z"><TD CLASS="l">534</TD><TD>                e.printStackTrace();</TD></TR><TR CLASS="z"><TD CLASS="l">535</TD><TD>                return false;</TD></TR><TR><TD CLASS="l">536</TD><TD>            }</TD></TR><TR><TD CLASS="l">537</TD><TD>        } else {</TD></TR><TR CLASS="z"><TD CLASS="l">538</TD><TD>            throw new IllegalArgumentException(&#34;One or more strings are null &#34;</TD></TR><TR><TD CLASS="l">539</TD><TD>                    + &#34;or of empty length&#34;);</TD></TR><TR><TD CLASS="l">540</TD><TD>        }</TD></TR><TR><TD CLASS="l">541</TD><TD>    }</TD></TR><TR><TD CLASS="l">542</TD><TD> </TD></TR><TR><TD CLASS="l">543</TD><TD>    /**</TD></TR><TR><TD CLASS="l">544</TD><TD>     * Attempts to modify a hospital to the database.</TD></TR><TR><TD CLASS="l">545</TD><TD>     * </TD></TR><TR><TD CLASS="l">546</TD><TD>     * @param hospital_id</TD></TR><TR><TD CLASS="l">547</TD><TD>     *            - id of the hospital being modified. THIS SHOULD NOT BE</TD></TR><TR><TD CLASS="l">548</TD><TD>     *            MODIFIABLE BY END USER.</TD></TR><TR><TD CLASS="l">549</TD><TD>     * @param name</TD></TR><TR><TD CLASS="l">550</TD><TD>     *            - name of the hospital</TD></TR><TR><TD CLASS="l">551</TD><TD>     * @param address</TD></TR><TR><TD CLASS="l">552</TD><TD>     *            - address of the hospital in the form: [Address 1], [Address</TD></TR><TR><TD CLASS="l">553</TD><TD>     *            2], [City], [State], [ZipCode]</TD></TR><TR><TD CLASS="l">554</TD><TD>     * </TD></TR><TR><TD CLASS="l">555</TD><TD>     * @returns Returns true if the modification to the database was successful.</TD></TR><TR><TD CLASS="l">556</TD><TD>     *          Otherwise, returns false.</TD></TR><TR><TD CLASS="l">557</TD><TD>     * </TD></TR><TR><TD CLASS="l">558</TD><TD>     * @throws IllegalStateException</TD></TR><TR><TD CLASS="l">559</TD><TD>     *             if the there is no connection to the database</TD></TR><TR><TD CLASS="l">560</TD><TD>     * @throws IllegalArgumentException</TD></TR><TR><TD CLASS="l">561</TD><TD>     *             if the parameters are invalid</TD></TR><TR><TD CLASS="l">562</TD><TD>     */</TD></TR><TR><TD CLASS="l"><A NAME="7">563</A></TD><TD>    public static boolean changeHospital(int hospital_id, String name,</TD></TR><TR><TD CLASS="l">564</TD><TD>            String address) throws IllegalStateException,</TD></TR><TR><TD CLASS="l">565</TD><TD>            IllegalArgumentException {</TD></TR><TR><TD CLASS="l">566</TD><TD> </TD></TR><TR CLASS="z"><TD CLASS="l">567</TD><TD>        noConnection();</TD></TR><TR><TD CLASS="l">568</TD><TD> </TD></TR><TR CLASS="z"><TD CLASS="l">569</TD><TD>        if (noNulls(name, address) &amp;&amp; lengthChecker(name, address)) {</TD></TR><TR><TD CLASS="l">570</TD><TD>            try {</TD></TR><TR CLASS="z"><TD CLASS="l">571</TD><TD>                dbConnection.changeRecord(new Hospital(hospital_id, name,</TD></TR><TR CLASS="z"><TD CLASS="l">572</TD><TD>                        address));</TD></TR><TR CLASS="z"><TD CLASS="l">573</TD><TD>                return true;</TD></TR><TR CLASS="z"><TD CLASS="l">574</TD><TD>            } catch (SQLException e) {</TD></TR><TR CLASS="z"><TD CLASS="l">575</TD><TD>                e.printStackTrace();</TD></TR><TR CLASS="z"><TD CLASS="l">576</TD><TD>                return false;</TD></TR><TR><TD CLASS="l">577</TD><TD>            }</TD></TR><TR><TD CLASS="l">578</TD><TD>        } else {</TD></TR><TR CLASS="z"><TD CLASS="l">579</TD><TD>            throw new IllegalArgumentException(&#34;Name or address is invalid&#34;);</TD></TR><TR><TD CLASS="l">580</TD><TD>        }</TD></TR><TR><TD CLASS="l">581</TD><TD>    }</TD></TR><TR><TD CLASS="l">582</TD><TD> </TD></TR><TR><TD CLASS="l">583</TD><TD>    /**</TD></TR><TR><TD CLASS="l">584</TD><TD>     * Attempts to modify shipping information to the database. This method can</TD></TR><TR><TD CLASS="l">585</TD><TD>     * not be used to change a specimen package. To add items to a shipping</TD></TR><TR><TD CLASS="l">586</TD><TD>     * information, please use the addItemsToSpec method. To update the specimen</TD></TR><TR><TD CLASS="l">587</TD><TD>     * use the changeSpecimenInfo method.</TD></TR><TR><TD CLASS="l">588</TD><TD>     * </TD></TR><TR><TD CLASS="l">589</TD><TD>     * @param barcode</TD></TR><TR><TD CLASS="l">590</TD><TD>     *            - a barcode used to identify the specimen. SHOULD NOT BE</TD></TR><TR><TD CLASS="l">591</TD><TD>     *            MODIFIABLE BY END USER.</TD></TR><TR><TD CLASS="l">592</TD><TD>     * @param username</TD></TR><TR><TD CLASS="l">593</TD><TD>     *            - the username of the person adding the specimen info</TD></TR><TR><TD CLASS="l">594</TD><TD>     * @param dest</TD></TR><TR><TD CLASS="l">595</TD><TD>     *            - an id representing a client site destination</TD></TR><TR><TD CLASS="l">596</TD><TD>     * @param status</TD></TR><TR><TD CLASS="l">597</TD><TD>     *            - an id representing a status type</TD></TR><TR><TD CLASS="l">598</TD><TD>     * @param cour</TD></TR><TR><TD CLASS="l">599</TD><TD>     *            - the username of the courier to be assigned</TD></TR><TR><TD CLASS="l">600</TD><TD>     * </TD></TR><TR><TD CLASS="l">601</TD><TD>     * @returns Returns true if the modification to the database was successful.</TD></TR><TR><TD CLASS="l">602</TD><TD>     *          Otherwise, returns false.</TD></TR><TR><TD CLASS="l">603</TD><TD>     * </TD></TR><TR><TD CLASS="l">604</TD><TD>     * @throws IllegalStateException</TD></TR><TR><TD CLASS="l">605</TD><TD>     *             if the there is no connection to the database</TD></TR><TR><TD CLASS="l">606</TD><TD>     * @throws IllegalArgumentException</TD></TR><TR><TD CLASS="l">607</TD><TD>     *             if there is an invalid argument</TD></TR><TR><TD CLASS="l">608</TD><TD>     */</TD></TR><TR><TD CLASS="l"><A NAME="8">609</A></TD><TD>    public static boolean changeShippingInformation(String barcode,</TD></TR><TR><TD CLASS="l">610</TD><TD>            String username, int dest, int status, String cour)</TD></TR><TR><TD CLASS="l">611</TD><TD>            throws IllegalStateException, IllegalArgumentException {</TD></TR><TR><TD CLASS="l">612</TD><TD> </TD></TR><TR CLASS="z"><TD CLASS="l">613</TD><TD>        noConnection();</TD></TR><TR><TD CLASS="l">614</TD><TD> </TD></TR><TR CLASS="z"><TD CLASS="l">615</TD><TD>        if (noNulls(username, getUser(username), getClientSite(dest))</TD></TR><TR CLASS="z"><TD CLASS="l">616</TD><TD>                &amp;&amp; barcode.length() &gt; 0) {</TD></TR><TR><TD CLASS="l">617</TD><TD>            try {</TD></TR><TR CLASS="z"><TD CLASS="l">618</TD><TD>                Courier c_temp = getCourierInfo(cour);</TD></TR><TR CLASS="z"><TD CLASS="l">619</TD><TD>                ShippingInformation temp = getShippingInfo(barcode);</TD></TR><TR CLASS="z"><TD CLASS="l">620</TD><TD>                Status newStatus = getStatus(status);</TD></TR><TR><TD CLASS="l">621</TD><TD> </TD></TR><TR CLASS="z"><TD CLASS="l">622</TD><TD>                if (!noNulls(c_temp, temp, newStatus)) {</TD></TR><TR CLASS="z"><TD CLASS="l">623</TD><TD>                    throw new IllegalArgumentException(</TD></TR><TR CLASS="z"><TD CLASS="l">624</TD><TD>                            &#34;Invalid barcode or courier&#34;);</TD></TR><TR><TD CLASS="l">625</TD><TD>                }</TD></TR><TR><TD CLASS="l">626</TD><TD> </TD></TR><TR CLASS="z"><TD CLASS="l">627</TD><TD>                dbConnection.changeRecord(new ShippingInformation(</TD></TR><TR CLASS="z"><TD CLASS="l">628</TD><TD>                        temp.specimen, getUser(username), getClientSite(dest),</TD></TR><TR CLASS="z"><TD CLASS="l">629</TD><TD>                        newStatus, c_temp));</TD></TR><TR CLASS="z"><TD CLASS="l">630</TD><TD>                return true;</TD></TR><TR CLASS="z"><TD CLASS="l">631</TD><TD>            } catch (SQLException e) {</TD></TR><TR CLASS="z"><TD CLASS="l">632</TD><TD>                e.printStackTrace();</TD></TR><TR CLASS="z"><TD CLASS="l">633</TD><TD>                return false;</TD></TR><TR><TD CLASS="l">634</TD><TD>            }</TD></TR><TR><TD CLASS="l">635</TD><TD>        } else {</TD></TR><TR CLASS="z"><TD CLASS="l">636</TD><TD>            throw new IllegalArgumentException(</TD></TR><TR CLASS="z"><TD CLASS="l">637</TD><TD>                    &#34;Null strings detected, ivalid username/destination or &#34;</TD></TR><TR><TD CLASS="l">638</TD><TD>                            + &#34;barcode is less than 1.&#34;);</TD></TR><TR><TD CLASS="l">639</TD><TD>        }</TD></TR><TR><TD CLASS="l">640</TD><TD>    }</TD></TR><TR><TD CLASS="l">641</TD><TD> </TD></TR><TR><TD CLASS="l">642</TD><TD>    /**</TD></TR><TR><TD CLASS="l">643</TD><TD>     * Attempts to modify a specimen in the database. Use this to update</TD></TR><TR><TD CLASS="l">644</TD><TD>     * existing specimen data.</TD></TR><TR><TD CLASS="l">645</TD><TD>     * </TD></TR><TR><TD CLASS="l">646</TD><TD>     * @param barcode</TD></TR><TR><TD CLASS="l">647</TD><TD>     *            - the barcode of the Specimen being modified. SHOULD NOT BE</TD></TR><TR><TD CLASS="l">648</TD><TD>     *            MODIFIABLE BY THE END USER.</TD></TR><TR><TD CLASS="l">649</TD><TD>     * @param desc</TD></TR><TR><TD CLASS="l">650</TD><TD>     *            - the description of the Specimen</TD></TR><TR><TD CLASS="l">651</TD><TD>     * @param requirements</TD></TR><TR><TD CLASS="l">652</TD><TD>     *            - the requirements of shipping for the Specimen</TD></TR><TR><TD CLASS="l">653</TD><TD>     * @param contents</TD></TR><TR><TD CLASS="l">654</TD><TD>     *            - the contents of the Specimen</TD></TR><TR><TD CLASS="l">655</TD><TD>     * </TD></TR><TR><TD CLASS="l">656</TD><TD>     * @returns Returns true if the addition to the database was successful.</TD></TR><TR><TD CLASS="l">657</TD><TD>     *          Otherwise, returns false.</TD></TR><TR><TD CLASS="l">658</TD><TD>     * </TD></TR><TR><TD CLASS="l">659</TD><TD>     * @throws IllegalStateException</TD></TR><TR><TD CLASS="l">660</TD><TD>     *             if the there is no connection to the database</TD></TR><TR><TD CLASS="l">661</TD><TD>     * @throws IllegalArgumentException</TD></TR><TR><TD CLASS="l">662</TD><TD>     *             if there is an invalid argument</TD></TR><TR><TD CLASS="l"><A NAME="9">663</A></TD><TD>     */</TD></TR><TR><TD CLASS="l">664</TD><TD>    public static boolean changeSpecimenInfo(String barcode, String desc,</TD></TR><TR><TD CLASS="l">665</TD><TD>            String requirements, Map&lt;Integer, List&lt;String&gt;&gt; items)</TD></TR><TR><TD CLASS="l">666</TD><TD>            throws IllegalStateException, IllegalArgumentException {</TD></TR><TR CLASS="z"><TD CLASS="l">667</TD><TD>        noConnection();</TD></TR><TR><TD CLASS="l">668</TD><TD> </TD></TR><TR CLASS="z"><TD CLASS="l">669</TD><TD>        Collection&lt;Item&gt; temp = new LinkedList&lt;Item&gt;();</TD></TR><TR><TD CLASS="l">670</TD><TD> </TD></TR><TR CLASS="z"><TD CLASS="l">671</TD><TD>        for (Integer i : items.keySet()) {</TD></TR><TR CLASS="z"><TD CLASS="l">672</TD><TD>            temp.add(new Item(i, items.get(i).get(0), items.get(i).get(1)));</TD></TR><TR><TD CLASS="l">673</TD><TD>        }</TD></TR><TR><TD CLASS="l">674</TD><TD> </TD></TR><TR CLASS="z"><TD CLASS="l">675</TD><TD>        if (noNulls(desc, requirements) &amp;&amp; barcode.length() &gt; 0</TD></TR><TR CLASS="z"><TD CLASS="l">676</TD><TD>                &amp;&amp; temp.size() &gt; 0) {</TD></TR><TR><TD CLASS="l">677</TD><TD>            try {</TD></TR><TR CLASS="z"><TD CLASS="l">678</TD><TD>                dbConnection.changeRecord(new Specimen(barcode, desc,</TD></TR><TR CLASS="z"><TD CLASS="l">679</TD><TD>                        requirements, temp));</TD></TR><TR CLASS="z"><TD CLASS="l">680</TD><TD>                return true;</TD></TR><TR CLASS="z"><TD CLASS="l">681</TD><TD>            } catch (SQLException e) {</TD></TR><TR CLASS="z"><TD CLASS="l">682</TD><TD>                e.printStackTrace();</TD></TR><TR CLASS="z"><TD CLASS="l">683</TD><TD>                return false;</TD></TR><TR><TD CLASS="l">684</TD><TD>            }</TD></TR><TR><TD CLASS="l">685</TD><TD>        } else {</TD></TR><TR CLASS="z"><TD CLASS="l">686</TD><TD>            throw new IllegalArgumentException(&#34;Description or requirements&#34;</TD></TR><TR><TD CLASS="l">687</TD><TD>                    + &#34;is empty&#34;);</TD></TR><TR><TD CLASS="l">688</TD><TD>        }</TD></TR><TR><TD CLASS="l">689</TD><TD>    }</TD></TR><TR><TD CLASS="l">690</TD><TD> </TD></TR><TR><TD CLASS="l">691</TD><TD>    /**</TD></TR><TR><TD CLASS="l">692</TD><TD>     * Attempts to modify a user to the database.</TD></TR><TR><TD CLASS="l">693</TD><TD>     * </TD></TR><TR><TD CLASS="l">694</TD><TD>     * @param username</TD></TR><TR><TD CLASS="l">695</TD><TD>     *            - The username of the person being added. SHOULD NOT BE</TD></TR><TR><TD CLASS="l">696</TD><TD>     *            MODIFIABLE BY END USER.</TD></TR><TR><TD CLASS="l">697</TD><TD>     * @param password</TD></TR><TR><TD CLASS="l">698</TD><TD>     *            - The password associated to the username</TD></TR><TR><TD CLASS="l">699</TD><TD>     * @param first</TD></TR><TR><TD CLASS="l">700</TD><TD>     *            - The first name of the person</TD></TR><TR><TD CLASS="l">701</TD><TD>     * @param last</TD></TR><TR><TD CLASS="l">702</TD><TD>     *            - The last name of the person</TD></TR><TR><TD CLASS="l">703</TD><TD>     * @param site_id</TD></TR><TR><TD CLASS="l">704</TD><TD>     *            - A client site that the person is assigned to</TD></TR><TR><TD CLASS="l">705</TD><TD>     * @param type_id</TD></TR><TR><TD CLASS="l">706</TD><TD>     *            - A user type regarding the person's privileges</TD></TR><TR><TD CLASS="l">707</TD><TD>     * </TD></TR><TR><TD CLASS="l">708</TD><TD>     * @returns Returns true if the modification to the database was successful.</TD></TR><TR><TD CLASS="l">709</TD><TD>     *          Otherwise, returns false.</TD></TR><TR><TD CLASS="l">710</TD><TD>     * </TD></TR><TR><TD CLASS="l">711</TD><TD>     * @throws IllegalStateException</TD></TR><TR><TD CLASS="l">712</TD><TD>     *             if the there is no connection to the database</TD></TR><TR><TD CLASS="l">713</TD><TD>     * @throws IllegalArgumentException</TD></TR><TR><TD CLASS="l">714</TD><TD>     *             if the arguments are not valid such as being null</TD></TR><TR><TD CLASS="l">715</TD><TD>     */</TD></TR><TR><TD CLASS="l"><A NAME="a">716</A></TD><TD>    public static boolean changeUser(String username, String password,</TD></TR><TR><TD CLASS="l">717</TD><TD>            String first, String last, int site_id, int type_id)</TD></TR><TR><TD CLASS="l">718</TD><TD>            throws IllegalStateException, IllegalArgumentException {</TD></TR><TR><TD CLASS="l">719</TD><TD> </TD></TR><TR CLASS="z"><TD CLASS="l">720</TD><TD>        noConnection();</TD></TR><TR><TD CLASS="l">721</TD><TD> </TD></TR><TR CLASS="z"><TD CLASS="l">722</TD><TD>        ClientSite cs = getClientSite(site_id);</TD></TR><TR CLASS="z"><TD CLASS="l">723</TD><TD>        UserType type = getUserType(type_id);</TD></TR><TR><TD CLASS="l">724</TD><TD> </TD></TR><TR CLASS="z"><TD CLASS="l">725</TD><TD>        if (noNulls(username, password, first, last, cs, type)</TD></TR><TR CLASS="z"><TD CLASS="l">726</TD><TD>                &amp;&amp; lengthChecker(username, password, first, last)) {</TD></TR><TR><TD CLASS="l">727</TD><TD> </TD></TR><TR CLASS="z"><TD CLASS="l">728</TD><TD>            if (getUser(username) == null) {</TD></TR><TR CLASS="z"><TD CLASS="l">729</TD><TD>                return false;</TD></TR><TR><TD CLASS="l">730</TD><TD>            }</TD></TR><TR><TD CLASS="l">731</TD><TD> </TD></TR><TR><TD CLASS="l">732</TD><TD>            try {</TD></TR><TR CLASS="z"><TD CLASS="l">733</TD><TD>                dbConnection.changeRecord(new User(username, password, first,</TD></TR><TR CLASS="z"><TD CLASS="l">734</TD><TD>                        last, cs, type));</TD></TR><TR CLASS="z"><TD CLASS="l">735</TD><TD>                return true;</TD></TR><TR CLASS="z"><TD CLASS="l">736</TD><TD>            } catch (SQLException e) {</TD></TR><TR CLASS="z"><TD CLASS="l">737</TD><TD>                e.printStackTrace();</TD></TR><TR CLASS="z"><TD CLASS="l">738</TD><TD>                return false;</TD></TR><TR><TD CLASS="l">739</TD><TD>            }</TD></TR><TR><TD CLASS="l">740</TD><TD>        } else {</TD></TR><TR CLASS="z"><TD CLASS="l">741</TD><TD>            throw new IllegalArgumentException(&#34;One or more of the parameters&#34;</TD></TR><TR><TD CLASS="l">742</TD><TD>                    + &#34; are invalid. Input must not be empty.&#34;);</TD></TR><TR><TD CLASS="l">743</TD><TD>        }</TD></TR><TR><TD CLASS="l">744</TD><TD> </TD></TR><TR><TD CLASS="l">745</TD><TD>    }</TD></TR><TR><TD CLASS="l">746</TD><TD> </TD></TR><TR><TD CLASS="l">747</TD><TD>    // ----------------------------------------------------------------------------</TD></TR><TR><TD CLASS="l">748</TD><TD>    // Methods that retrieve information from the database</TD></TR><TR><TD CLASS="l">749</TD><TD>    // ----------------------------------------------------------------------------</TD></TR><TR><TD CLASS="l">750</TD><TD> </TD></TR><TR><TD CLASS="l">751</TD><TD>    /**</TD></TR><TR><TD CLASS="l">752</TD><TD>     * Attempts to retrieve information related to the username and password.</TD></TR><TR><TD CLASS="l">753</TD><TD>     * </TD></TR><TR><TD CLASS="l">754</TD><TD>     * @param username</TD></TR><TR><TD CLASS="l">755</TD><TD>     *            The username of the person whose information is being looked</TD></TR><TR><TD CLASS="l">756</TD><TD>     *            up</TD></TR><TR><TD CLASS="l">757</TD><TD>     * @param password</TD></TR><TR><TD CLASS="l">758</TD><TD>     *            The password associated to the username</TD></TR><TR><TD CLASS="l">759</TD><TD>     * @return Returns the User object associated to the given username and</TD></TR><TR><TD CLASS="l"><A NAME="21">760</A></TD><TD>     *         password. If no username and/or password combination is in the</TD></TR><TR><TD CLASS="l">761</TD><TD>     *         database, returns null.</TD></TR><TR><TD CLASS="l">762</TD><TD>     */</TD></TR><TR><TD CLASS="l">763</TD><TD>    public static User getUserInfo(String username, String password) {</TD></TR><TR CLASS="z"><TD CLASS="l">764</TD><TD>        noConnection();</TD></TR><TR CLASS="z"><TD CLASS="l">765</TD><TD>        return dbConnection.login(username, password);</TD></TR><TR><TD CLASS="l">766</TD><TD>    }</TD></TR><TR><TD CLASS="l">767</TD><TD> </TD></TR><TR><TD CLASS="l">768</TD><TD>    /**</TD></TR><TR><TD CLASS="l">769</TD><TD>     * Attempts to retrieve the user type of the given username.</TD></TR><TR><TD CLASS="l">770</TD><TD>     * </TD></TR><TR><TD CLASS="l">771</TD><TD>     * @param username</TD></TR><TR><TD CLASS="l">772</TD><TD>     *            - the username to be looked up</TD></TR><TR><TD CLASS="l">773</TD><TD>     * </TD></TR><TR><TD CLASS="l">774</TD><TD>     * @return Returns the &lt;code&gt;UserType&lt;/code&gt; object corresponding to the</TD></TR><TR><TD CLASS="l"><A NAME="22">775</A></TD><TD>     *         given username, if applicable. Otherwise, returns &lt;code&gt;null</TD></TR><TR><TD CLASS="l">776</TD><TD>     *          &lt;/code&gt;</TD></TR><TR><TD CLASS="l">777</TD><TD>     */</TD></TR><TR><TD CLASS="l">778</TD><TD>    public static UserType getUserType(String username) {</TD></TR><TR CLASS="z"><TD CLASS="l">779</TD><TD>        noConnection();</TD></TR><TR><TD CLASS="l">780</TD><TD>        try {</TD></TR><TR CLASS="z"><TD CLASS="l">781</TD><TD>            return dbConnection.getUserType(username);</TD></TR><TR CLASS="z"><TD CLASS="l">782</TD><TD>        } catch (SQLException e) {</TD></TR><TR CLASS="z"><TD CLASS="l">783</TD><TD>            e.printStackTrace();</TD></TR><TR><TD CLASS="l">784</TD><TD>        }</TD></TR><TR CLASS="z"><TD CLASS="l">785</TD><TD>        return null;</TD></TR><TR><TD CLASS="l">786</TD><TD>    }</TD></TR><TR><TD CLASS="l">787</TD><TD> </TD></TR><TR><TD CLASS="l">788</TD><TD>    /**</TD></TR><TR><TD CLASS="l">789</TD><TD>     * Attempts to retrieve the courier corresponding to the username.</TD></TR><TR><TD CLASS="l">790</TD><TD>     * </TD></TR><TR><TD CLASS="l">791</TD><TD>     * @param username</TD></TR><TR><TD CLASS="l">792</TD><TD>     *            - the username to be looked up</TD></TR><TR><TD CLASS="l">793</TD><TD>     * </TD></TR><TR><TD CLASS="l">794</TD><TD>     * @return Returns the &lt;code&gt;Courier&lt;/code&gt; object corresponding to the</TD></TR><TR><TD CLASS="l"><A NAME="19">795</A></TD><TD>     *         given username, if applicable. Otherwise, returns &lt;code&gt;null</TD></TR><TR><TD CLASS="l">796</TD><TD>     *          &lt;/code&gt;</TD></TR><TR><TD CLASS="l">797</TD><TD>     */</TD></TR><TR><TD CLASS="l">798</TD><TD>    public static Courier getCourierInfo(String username) {</TD></TR><TR CLASS="z"><TD CLASS="l">799</TD><TD>        noConnection();</TD></TR><TR><TD CLASS="l">800</TD><TD>        try {</TD></TR><TR CLASS="z"><TD CLASS="l">801</TD><TD>            return dbConnection.getCourierByID(username);</TD></TR><TR CLASS="z"><TD CLASS="l">802</TD><TD>        } catch (SQLException e) {</TD></TR><TR CLASS="z"><TD CLASS="l">803</TD><TD>            e.printStackTrace();</TD></TR><TR CLASS="z"><TD CLASS="l">804</TD><TD>            return null;</TD></TR><TR><TD CLASS="l">805</TD><TD>        }</TD></TR><TR><TD CLASS="l">806</TD><TD>    }</TD></TR><TR><TD CLASS="l">807</TD><TD> </TD></TR><TR><TD CLASS="l">808</TD><TD>    /**</TD></TR><TR><TD CLASS="l">809</TD><TD>     * Attempts to retrieve the courier corresponding to the username.</TD></TR><TR><TD CLASS="l">810</TD><TD>     * </TD></TR><TR><TD CLASS="l">811</TD><TD>     * @param username</TD></TR><TR><TD CLASS="l">812</TD><TD>     *            - the username to be looked up</TD></TR><TR><TD CLASS="l">813</TD><TD>     * </TD></TR><TR><TD CLASS="l">814</TD><TD>     * @return Returns the &lt;code&gt;Courier&lt;/code&gt; object corresponding to the</TD></TR><TR><TD CLASS="l"><A NAME="1d">815</A></TD><TD>     *         given username, if applicable. Otherwise, returns &lt;code&gt;null</TD></TR><TR><TD CLASS="l">816</TD><TD>     *          &lt;/code&gt;</TD></TR><TR><TD CLASS="l">817</TD><TD>     */</TD></TR><TR><TD CLASS="l">818</TD><TD>    public static List&lt;ClientSite&gt; getRoute(String username) {</TD></TR><TR CLASS="z"><TD CLASS="l">819</TD><TD>        noConnection();</TD></TR><TR CLASS="z"><TD CLASS="l">820</TD><TD>        Courier temp = getCourierInfo(username);</TD></TR><TR CLASS="z"><TD CLASS="l">821</TD><TD>        if (temp != null) {</TD></TR><TR CLASS="z"><TD CLASS="l">822</TD><TD>            return temp.route;</TD></TR><TR><TD CLASS="l">823</TD><TD>        } else {</TD></TR><TR CLASS="z"><TD CLASS="l">824</TD><TD>            return null;</TD></TR><TR><TD CLASS="l">825</TD><TD>        }</TD></TR><TR><TD CLASS="l">826</TD><TD>    }</TD></TR><TR><TD CLASS="l">827</TD><TD> </TD></TR><TR><TD CLASS="l">828</TD><TD>    /**</TD></TR><TR><TD CLASS="l">829</TD><TD>     * Attempts to retrieve the shipping information containing the given bar</TD></TR><TR><TD CLASS="l">830</TD><TD>     * code.</TD></TR><TR><TD CLASS="l">831</TD><TD>     * </TD></TR><TR><TD CLASS="l">832</TD><TD>     * @param barcode</TD></TR><TR><TD CLASS="l">833</TD><TD>     *            - the bar code to be looked up</TD></TR><TR><TD CLASS="l">834</TD><TD>     * </TD></TR><TR><TD CLASS="l">835</TD><TD>     * @return Returns the &lt;code&gt;ShippingInformation&lt;/code&gt; object corresponding</TD></TR><TR><TD CLASS="l"><A NAME="2e">836</A></TD><TD>     *         to the given username, if applicable. Otherwise, returns</TD></TR><TR><TD CLASS="l">837</TD><TD>     *         &lt;code&gt;null&lt;/code&gt;</TD></TR><TR><TD CLASS="l">838</TD><TD>     */</TD></TR><TR><TD CLASS="l">839</TD><TD>    public static ShippingInformation getShippingInfo(String barcode) {</TD></TR><TR CLASS="c"><TD CLASS="l">840</TD><TD>        noConnection();</TD></TR><TR><TD CLASS="l">841</TD><TD>        try {</TD></TR><TR CLASS="c"><TD CLASS="l">842</TD><TD>            return dbConnection.getShippingInfoFor(barcode);</TD></TR><TR CLASS="z"><TD CLASS="l">843</TD><TD>        } catch (SQLException e) {</TD></TR><TR CLASS="z"><TD CLASS="l">844</TD><TD>            e.printStackTrace();</TD></TR><TR CLASS="z"><TD CLASS="l">845</TD><TD>            return null;</TD></TR><TR><TD CLASS="l">846</TD><TD>        }</TD></TR><TR><TD CLASS="l">847</TD><TD>    }</TD></TR><TR><TD CLASS="l">848</TD><TD> </TD></TR><TR><TD CLASS="l">849</TD><TD>    /**</TD></TR><TR><TD CLASS="l">850</TD><TD>     * Attempts to retrieve the specimen containing the given bar code.</TD></TR><TR><TD CLASS="l">851</TD><TD>     * </TD></TR><TR><TD CLASS="l">852</TD><TD>     * @param barcode</TD></TR><TR><TD CLASS="l">853</TD><TD>     *            - the bar code to be looked up</TD></TR><TR><TD CLASS="l">854</TD><TD>     * </TD></TR><TR><TD CLASS="l">855</TD><TD>     * @return Returns the &lt;code&gt;Specimen&lt;/code&gt; object corresponding to the</TD></TR><TR><TD CLASS="l"><A NAME="1e">856</A></TD><TD>     *         given username, if applicable. Otherwise, returns &lt;code&gt;null</TD></TR><TR><TD CLASS="l">857</TD><TD>     *          &lt;/code&gt;</TD></TR><TR><TD CLASS="l">858</TD><TD>     */</TD></TR><TR><TD CLASS="l">859</TD><TD>    public static Specimen getSpecimen(String barcode) {</TD></TR><TR CLASS="z"><TD CLASS="l">860</TD><TD>        noConnection();</TD></TR><TR><TD CLASS="l">861</TD><TD>        try {</TD></TR><TR CLASS="z"><TD CLASS="l">862</TD><TD>            return dbConnection.getSpecimenByID(barcode);</TD></TR><TR CLASS="z"><TD CLASS="l">863</TD><TD>        } catch (SQLException e) {</TD></TR><TR CLASS="z"><TD CLASS="l">864</TD><TD>            e.printStackTrace();</TD></TR><TR CLASS="z"><TD CLASS="l">865</TD><TD>            return null;</TD></TR><TR><TD CLASS="l">866</TD><TD>        }</TD></TR><TR><TD CLASS="l">867</TD><TD>    }</TD></TR><TR><TD CLASS="l">868</TD><TD> </TD></TR><TR><TD CLASS="l">869</TD><TD>    /**</TD></TR><TR><TD CLASS="l">870</TD><TD>     * Attempts to retrieve shipping information from a client site.</TD></TR><TR><TD CLASS="l">871</TD><TD>     * </TD></TR><TR><TD CLASS="l">872</TD><TD>     * @param c</TD></TR><TR><TD CLASS="l">873</TD><TD>     *            - the ClientSite to be looked up</TD></TR><TR><TD CLASS="l">874</TD><TD>     * </TD></TR><TR><TD CLASS="l">875</TD><TD>     * @return Returns a &lt;code&gt;List&amp;lt;ShippingInformation&amp;gt;&lt;/code&gt; object</TD></TR><TR><TD CLASS="l"><A NAME="26">876</A></TD><TD>     *         containing all the shipping information for the given client</TD></TR><TR><TD CLASS="l">877</TD><TD>     *         site. Otherwise, returns &lt;code&gt;null&lt;/code&gt;</TD></TR><TR><TD CLASS="l">878</TD><TD>     */</TD></TR><TR><TD CLASS="l">879</TD><TD>    public static List&lt;ShippingInformation&gt; specimenFrom(ClientSite c) {</TD></TR><TR CLASS="z"><TD CLASS="l">880</TD><TD>        noConnection();</TD></TR><TR><TD CLASS="l">881</TD><TD>        try {</TD></TR><TR CLASS="z"><TD CLASS="l">882</TD><TD>            return dbConnection.specimensFrom(c);</TD></TR><TR CLASS="z"><TD CLASS="l">883</TD><TD>        } catch (SQLException e) {</TD></TR><TR CLASS="z"><TD CLASS="l">884</TD><TD>            e.printStackTrace();</TD></TR><TR CLASS="z"><TD CLASS="l">885</TD><TD>            return null;</TD></TR><TR><TD CLASS="l">886</TD><TD>        }</TD></TR><TR><TD CLASS="l">887</TD><TD>    }</TD></TR><TR><TD CLASS="l">888</TD><TD> </TD></TR><TR><TD CLASS="l">889</TD><TD>    /**</TD></TR><TR><TD CLASS="l">890</TD><TD>     * Attempts to retrieve shipping information from a client site.</TD></TR><TR><TD CLASS="l">891</TD><TD>     * </TD></TR><TR><TD CLASS="l">892</TD><TD>     * @param c</TD></TR><TR><TD CLASS="l">893</TD><TD>     *            - the ClientSite to be looked up</TD></TR><TR><TD CLASS="l">894</TD><TD>     * </TD></TR><TR><TD CLASS="l">895</TD><TD>     * @return Returns a &lt;code&gt;List&amp;lt;ShippingInformation&amp;gt;&lt;/code&gt; object</TD></TR><TR><TD CLASS="l"><A NAME="27">896</A></TD><TD>     *         containing all the shipping information for the given client</TD></TR><TR><TD CLASS="l">897</TD><TD>     *         site. Otherwise, returns &lt;code&gt;null&lt;/code&gt;</TD></TR><TR><TD CLASS="l">898</TD><TD>     */</TD></TR><TR><TD CLASS="l">899</TD><TD>    public static List&lt;ShippingInformation&gt; specimensTo(ClientSite c) {</TD></TR><TR CLASS="z"><TD CLASS="l">900</TD><TD>        noConnection();</TD></TR><TR><TD CLASS="l">901</TD><TD>        try {</TD></TR><TR CLASS="z"><TD CLASS="l">902</TD><TD>            return dbConnection.specimensTo(c);</TD></TR><TR CLASS="z"><TD CLASS="l">903</TD><TD>        } catch (SQLException e) {</TD></TR><TR CLASS="z"><TD CLASS="l">904</TD><TD>            e.printStackTrace();</TD></TR><TR CLASS="z"><TD CLASS="l">905</TD><TD>            return null;</TD></TR><TR><TD CLASS="l">906</TD><TD>        }</TD></TR><TR><TD CLASS="l">907</TD><TD>    }</TD></TR><TR><TD CLASS="l">908</TD><TD> </TD></TR><TR><TD CLASS="l">909</TD><TD>    /**</TD></TR><TR><TD CLASS="l">910</TD><TD>     * Attempts to retrieve all shipping information in the database.</TD></TR><TR><TD CLASS="l">911</TD><TD>     * </TD></TR><TR><TD CLASS="l">912</TD><TD>     * @return Returns a &lt;code&gt;List&amp;lt;ShippingInformation&amp;gt;&lt;/code&gt; object</TD></TR><TR><TD CLASS="l"><A NAME="10">913</A></TD><TD>     *         containing all the shipping information in the database.</TD></TR><TR><TD CLASS="l">914</TD><TD>     *         Otherwise, returns &lt;code&gt;null&lt;/code&gt;</TD></TR><TR><TD CLASS="l">915</TD><TD>     */</TD></TR><TR><TD CLASS="l">916</TD><TD>    public static List&lt;ShippingInformation&gt; getAllShippingInformation() {</TD></TR><TR CLASS="z"><TD CLASS="l">917</TD><TD>        noConnection();</TD></TR><TR><TD CLASS="l">918</TD><TD>        try {</TD></TR><TR CLASS="z"><TD CLASS="l">919</TD><TD>            return dbConnection.getAllShippingInformation();</TD></TR><TR CLASS="z"><TD CLASS="l">920</TD><TD>        } catch (SQLException e) {</TD></TR><TR CLASS="z"><TD CLASS="l">921</TD><TD>            e.printStackTrace();</TD></TR><TR CLASS="z"><TD CLASS="l">922</TD><TD>            return null;</TD></TR><TR><TD CLASS="l">923</TD><TD>        }</TD></TR><TR><TD CLASS="l">924</TD><TD>    }</TD></TR><TR><TD CLASS="l">925</TD><TD> </TD></TR><TR><TD CLASS="l">926</TD><TD>    /**</TD></TR><TR><TD CLASS="l">927</TD><TD>     * Attempts to retrieve all client sites in the database.</TD></TR><TR><TD CLASS="l">928</TD><TD>     * </TD></TR><TR><TD CLASS="l">929</TD><TD>     * @return Returns a &lt;code&gt;List&amp;lt;ClientSite&amp;gt;&lt;/code&gt; object containing</TD></TR><TR><TD CLASS="l"><A NAME="d">930</A></TD><TD>     *         all the client sites in the database. Otherwise, returns</TD></TR><TR><TD CLASS="l">931</TD><TD>     *         &lt;code&gt;null&lt;/code&gt;</TD></TR><TR><TD CLASS="l">932</TD><TD>     */</TD></TR><TR><TD CLASS="l">933</TD><TD>    public static List&lt;ClientSite&gt; getAllClientSites() {</TD></TR><TR CLASS="z"><TD CLASS="l">934</TD><TD>        noConnection();</TD></TR><TR><TD CLASS="l">935</TD><TD>        try {</TD></TR><TR CLASS="z"><TD CLASS="l">936</TD><TD>            return dbConnection.getAllClientSites();</TD></TR><TR CLASS="z"><TD CLASS="l">937</TD><TD>        } catch (SQLException e) {</TD></TR><TR CLASS="z"><TD CLASS="l">938</TD><TD>            e.printStackTrace();</TD></TR><TR CLASS="z"><TD CLASS="l">939</TD><TD>            return null;</TD></TR><TR><TD CLASS="l">940</TD><TD>        }</TD></TR><TR><TD CLASS="l">941</TD><TD>    }</TD></TR><TR><TD CLASS="l">942</TD><TD> </TD></TR><TR><TD CLASS="l">943</TD><TD>    /**</TD></TR><TR><TD CLASS="l">944</TD><TD>     * Attempts to retrieve all couriers in the database.</TD></TR><TR><TD CLASS="l">945</TD><TD>     * </TD></TR><TR><TD CLASS="l">946</TD><TD>     * @return Returns a &lt;code&gt;List&amp;lt;Courier&amp;gt;&lt;/code&gt; object containing all</TD></TR><TR><TD CLASS="l"><A NAME="e">947</A></TD><TD>     *         the couriers in the database. Otherwise, returns &lt;code&gt;null</TD></TR><TR><TD CLASS="l">948</TD><TD>     *          &lt;/code&gt;</TD></TR><TR><TD CLASS="l">949</TD><TD>     */</TD></TR><TR><TD CLASS="l">950</TD><TD>    public static List&lt;Courier&gt; getAllCouriers() {</TD></TR><TR CLASS="z"><TD CLASS="l">951</TD><TD>        noConnection();</TD></TR><TR><TD CLASS="l">952</TD><TD>        try {</TD></TR><TR CLASS="z"><TD CLASS="l">953</TD><TD>            return dbConnection.getAllCouriers();</TD></TR><TR CLASS="z"><TD CLASS="l">954</TD><TD>        } catch (SQLException e) {</TD></TR><TR CLASS="z"><TD CLASS="l">955</TD><TD>            e.printStackTrace();</TD></TR><TR CLASS="z"><TD CLASS="l">956</TD><TD>            return null;</TD></TR><TR><TD CLASS="l">957</TD><TD>        }</TD></TR><TR><TD CLASS="l">958</TD><TD>    }</TD></TR><TR><TD CLASS="l">959</TD><TD> </TD></TR><TR><TD CLASS="l">960</TD><TD>    /**</TD></TR><TR><TD CLASS="l">961</TD><TD>     * Attempts to retrieve all hospitals in the database.</TD></TR><TR><TD CLASS="l">962</TD><TD>     * </TD></TR><TR><TD CLASS="l">963</TD><TD>     * @return Returns a &lt;code&gt;List&amp;lt;Hospital&amp;gt;&lt;/code&gt; object containing all</TD></TR><TR><TD CLASS="l"><A NAME="2a">964</A></TD><TD>     *         the hospitals in the database. Otherwise, returns &lt;code&gt;null</TD></TR><TR><TD CLASS="l">965</TD><TD>     *          &lt;/code&gt;</TD></TR><TR><TD CLASS="l">966</TD><TD>     */</TD></TR><TR><TD CLASS="l">967</TD><TD>    public static List&lt;Hospital&gt; getAllHospitals() {</TD></TR><TR CLASS="c"><TD CLASS="l">968</TD><TD>        noConnection();</TD></TR><TR><TD CLASS="l">969</TD><TD>        try {</TD></TR><TR CLASS="c"><TD CLASS="l">970</TD><TD>            return dbConnection.getAllHospitals();</TD></TR><TR CLASS="z"><TD CLASS="l">971</TD><TD>        } catch (SQLException e) {</TD></TR><TR CLASS="z"><TD CLASS="l">972</TD><TD>            logger.warning(&#34;Should not error here when getting hospitals&#34;);</TD></TR><TR CLASS="z"><TD CLASS="l">973</TD><TD>            e.printStackTrace();</TD></TR><TR CLASS="z"><TD CLASS="l">974</TD><TD>            return null;</TD></TR><TR><TD CLASS="l">975</TD><TD>        }</TD></TR><TR><TD CLASS="l">976</TD><TD>    }</TD></TR><TR><TD CLASS="l">977</TD><TD> </TD></TR><TR><TD CLASS="l">978</TD><TD>    /**</TD></TR><TR><TD CLASS="l">979</TD><TD>     * Attempts to retrieve all user types in the database.</TD></TR><TR><TD CLASS="l">980</TD><TD>     * </TD></TR><TR><TD CLASS="l"><A NAME="2c">981</A></TD><TD>     * @return Returns a &lt;code&gt;List&amp;lt;Item&amp;gt;&lt;/code&gt; object containing all the</TD></TR><TR><TD CLASS="l">982</TD><TD>     *         items in the database. Otherwise, returns &lt;code&gt;null&lt;/code&gt;</TD></TR><TR><TD CLASS="l">983</TD><TD>     */</TD></TR><TR><TD CLASS="l">984</TD><TD>    public static List&lt;Item&gt; getAllItems() {</TD></TR><TR CLASS="c"><TD CLASS="l">985</TD><TD>        noConnection();</TD></TR><TR><TD CLASS="l">986</TD><TD>        try {</TD></TR><TR CLASS="c"><TD CLASS="l">987</TD><TD>            return dbConnection.getAllItems();</TD></TR><TR CLASS="z"><TD CLASS="l">988</TD><TD>        } catch (SQLException e) {</TD></TR><TR CLASS="z"><TD CLASS="l">989</TD><TD>            e.printStackTrace();</TD></TR><TR CLASS="z"><TD CLASS="l">990</TD><TD>            return null;</TD></TR><TR><TD CLASS="l">991</TD><TD>        }</TD></TR><TR><TD CLASS="l">992</TD><TD>    }</TD></TR><TR><TD CLASS="l">993</TD><TD> </TD></TR><TR><TD CLASS="l">994</TD><TD>    /**</TD></TR><TR><TD CLASS="l">995</TD><TD>     * Attempts to retrieve all specimens in the database.</TD></TR><TR><TD CLASS="l">996</TD><TD>     * </TD></TR><TR><TD CLASS="l">997</TD><TD>     * @return Returns a &lt;code&gt;List&amp;lt;Specimen&amp;gt;&lt;/code&gt; object containing all</TD></TR><TR><TD CLASS="l"><A NAME="12">998</A></TD><TD>     *         the specimens in the database. Otherwise, returns &lt;code&gt;null</TD></TR><TR><TD CLASS="l">999</TD><TD>     *          &lt;/code&gt;</TD></TR><TR><TD CLASS="l">1000</TD><TD>     */</TD></TR><TR><TD CLASS="l">1001</TD><TD>    public static List&lt;Specimen&gt; getAllSpecimens() {</TD></TR><TR CLASS="z"><TD CLASS="l">1002</TD><TD>        noConnection();</TD></TR><TR><TD CLASS="l">1003</TD><TD>        try {</TD></TR><TR CLASS="z"><TD CLASS="l">1004</TD><TD>            return dbConnection.getAllSpecimens();</TD></TR><TR CLASS="z"><TD CLASS="l">1005</TD><TD>        } catch (SQLException e) {</TD></TR><TR CLASS="z"><TD CLASS="l">1006</TD><TD>            e.printStackTrace();</TD></TR><TR CLASS="z"><TD CLASS="l">1007</TD><TD>            return null;</TD></TR><TR><TD CLASS="l">1008</TD><TD>        }</TD></TR><TR><TD CLASS="l">1009</TD><TD>    }</TD></TR><TR><TD CLASS="l">1010</TD><TD> </TD></TR><TR><TD CLASS="l">1011</TD><TD>    /**</TD></TR><TR><TD CLASS="l">1012</TD><TD>     * Attempts to retrieve all user types in the database.</TD></TR><TR><TD CLASS="l">1013</TD><TD>     * </TD></TR><TR><TD CLASS="l">1014</TD><TD>     * @return Returns a &lt;code&gt;List&amp;lt;UserType&amp;gt;&lt;/code&gt; object containing all</TD></TR><TR><TD CLASS="l"><A NAME="15">1015</A></TD><TD>     *         the user types in the database. Otherwise, returns &lt;code&gt;</TD></TR><TR><TD CLASS="l">1016</TD><TD>     *          null&lt;/code&gt;</TD></TR><TR><TD CLASS="l">1017</TD><TD>     */</TD></TR><TR><TD CLASS="l">1018</TD><TD>    public static List&lt;UserType&gt; getAllUserTypes() {</TD></TR><TR CLASS="z"><TD CLASS="l">1019</TD><TD>        noConnection();</TD></TR><TR><TD CLASS="l">1020</TD><TD>        try {</TD></TR><TR CLASS="z"><TD CLASS="l">1021</TD><TD>            return dbConnection.getAllUserTypes();</TD></TR><TR CLASS="z"><TD CLASS="l">1022</TD><TD>        } catch (SQLException e) {</TD></TR><TR CLASS="z"><TD CLASS="l">1023</TD><TD>            e.printStackTrace();</TD></TR><TR CLASS="z"><TD CLASS="l">1024</TD><TD>            return null;</TD></TR><TR><TD CLASS="l">1025</TD><TD>        }</TD></TR><TR><TD CLASS="l">1026</TD><TD>    }</TD></TR><TR><TD CLASS="l">1027</TD><TD> </TD></TR><TR><TD CLASS="l">1028</TD><TD>    /**</TD></TR><TR><TD CLASS="l">1029</TD><TD>     * Attempts to retrieve all users in the database.</TD></TR><TR><TD CLASS="l">1030</TD><TD>     * </TD></TR><TR><TD CLASS="l"><A NAME="16">1031</A></TD><TD>     * @return Returns a &lt;code&gt;List&amp;lt;User&amp;gt;&lt;/code&gt; object containing all the</TD></TR><TR><TD CLASS="l">1032</TD><TD>     *         users in the database. Otherwise, returns &lt;code&gt;null&lt;/code&gt;</TD></TR><TR><TD CLASS="l">1033</TD><TD>     */</TD></TR><TR><TD CLASS="l">1034</TD><TD>    public static List&lt;User&gt; getAllUsers() {</TD></TR><TR CLASS="z"><TD CLASS="l">1035</TD><TD>        noConnection();</TD></TR><TR><TD CLASS="l">1036</TD><TD>        try {</TD></TR><TR CLASS="z"><TD CLASS="l">1037</TD><TD>            return dbConnection.getAllUsers();</TD></TR><TR CLASS="z"><TD CLASS="l">1038</TD><TD>        } catch (SQLException e) {</TD></TR><TR CLASS="z"><TD CLASS="l">1039</TD><TD>            e.printStackTrace();</TD></TR><TR CLASS="z"><TD CLASS="l">1040</TD><TD>            return null;</TD></TR><TR><TD CLASS="l">1041</TD><TD>        }</TD></TR><TR><TD CLASS="l">1042</TD><TD>    }</TD></TR><TR><TD CLASS="l">1043</TD><TD> </TD></TR><TR><TD CLASS="l">1044</TD><TD>    /**</TD></TR><TR><TD CLASS="l">1045</TD><TD>     * Attempts to retrieve all couriers currently in transit.</TD></TR><TR><TD CLASS="l">1046</TD><TD>     * </TD></TR><TR><TD CLASS="l">1047</TD><TD>     * @return Returns a &lt;code&gt;List&amp;lt;Courier&amp;gt;&lt;/code&gt; object containing all</TD></TR><TR><TD CLASS="l"><A NAME="1b">1048</A></TD><TD>     *         the couriers in transit. Otherwise, returns &lt;code&gt;null</TD></TR><TR><TD CLASS="l">1049</TD><TD>     *          &lt;/code&gt;</TD></TR><TR><TD CLASS="l">1050</TD><TD>     */</TD></TR><TR><TD CLASS="l">1051</TD><TD>    public static List&lt;Courier&gt; getInTransitCouriers() {</TD></TR><TR CLASS="z"><TD CLASS="l">1052</TD><TD>        List&lt;Courier&gt; temp = getAllCouriers();</TD></TR><TR CLASS="z"><TD CLASS="l">1053</TD><TD>        List&lt;Courier&gt; inTransit = new LinkedList&lt;Courier&gt;();</TD></TR><TR CLASS="z"><TD CLASS="l">1054</TD><TD>        for (Courier x : temp) {</TD></TR><TR CLASS="z"><TD CLASS="l">1055</TD><TD>            if (x.longitude != 0.0 &amp;&amp; x.latitude != 0.0) {</TD></TR><TR CLASS="z"><TD CLASS="l">1056</TD><TD>                inTransit.add(x);</TD></TR><TR><TD CLASS="l">1057</TD><TD>            }</TD></TR><TR><TD CLASS="l">1058</TD><TD>        }</TD></TR><TR CLASS="z"><TD CLASS="l">1059</TD><TD>        return inTransit;</TD></TR><TR><TD CLASS="l">1060</TD><TD>    }</TD></TR><TR><TD CLASS="l">1061</TD><TD> </TD></TR><TR><TD CLASS="l">1062</TD><TD>    /**</TD></TR><TR><TD CLASS="l">1063</TD><TD>     * Deprecated.</TD></TR><TR><TD CLASS="l">1064</TD><TD>     * </TD></TR><TR><TD CLASS="l">1065</TD><TD>     * @param user</TD></TR><TR><TD CLASS="l">1066</TD><TD>     *            - username of shipping</TD></TR><TR><TD CLASS="l"><A NAME="f">1067</A></TD><TD>     * </TD></TR><TR><TD CLASS="l">1068</TD><TD>     * @return Return list of ShippingInformation</TD></TR><TR><TD CLASS="l">1069</TD><TD>     */</TD></TR><TR><TD CLASS="l">1070</TD><TD>    public static List&lt;ShippingInformation&gt; getAllShippingByUser(String user) {</TD></TR><TR CLASS="z"><TD CLASS="l">1071</TD><TD>        List&lt;ShippingInformation&gt; ret = new LinkedList&lt;ShippingInformation&gt;();</TD></TR><TR><TD CLASS="l">1072</TD><TD> </TD></TR><TR CLASS="z"><TD CLASS="l">1073</TD><TD>        for (ShippingInformation x : getAllShippingInformation()) {</TD></TR><TR CLASS="z"><TD CLASS="l">1074</TD><TD>            if (x.shipper.username.toLowerCase().equals(user.toLowerCase())) {</TD></TR><TR CLASS="z"><TD CLASS="l">1075</TD><TD>                ret.add(x);</TD></TR><TR><TD CLASS="l">1076</TD><TD>            }</TD></TR><TR><TD CLASS="l">1077</TD><TD>        }</TD></TR><TR CLASS="z"><TD CLASS="l">1078</TD><TD>        return ret;</TD></TR><TR><TD CLASS="l">1079</TD><TD>    }</TD></TR><TR><TD CLASS="l">1080</TD><TD> </TD></TR><TR><TD CLASS="l">1081</TD><TD>    /**</TD></TR><TR><TD CLASS="l">1082</TD><TD>     * Attempts to retrieve a check list from the database.</TD></TR><TR><TD CLASS="l"><A NAME="17">1083</A></TD><TD>     * </TD></TR><TR><TD CLASS="l">1084</TD><TD>     * @return Returns a CheckListPair if found. Otherwise, returns null.</TD></TR><TR><TD CLASS="l">1085</TD><TD>     */</TD></TR><TR><TD CLASS="l">1086</TD><TD>    public static CheckListPair getCheckLists() {</TD></TR><TR CLASS="z"><TD CLASS="l">1087</TD><TD>        noConnection();</TD></TR><TR><TD CLASS="l">1088</TD><TD>        try {</TD></TR><TR CLASS="z"><TD CLASS="l">1089</TD><TD>            return dbConnection.getCheckLists();</TD></TR><TR CLASS="z"><TD CLASS="l">1090</TD><TD>        } catch (SQLException e) {</TD></TR><TR CLASS="z"><TD CLASS="l">1091</TD><TD>            e.printStackTrace();</TD></TR><TR CLASS="z"><TD CLASS="l">1092</TD><TD>            return null;</TD></TR><TR><TD CLASS="l">1093</TD><TD>        }</TD></TR><TR><TD CLASS="l">1094</TD><TD>    }</TD></TR><TR><TD CLASS="l">1095</TD><TD> </TD></TR><TR><TD CLASS="l">1096</TD><TD>    /**</TD></TR><TR><TD CLASS="l">1097</TD><TD>     * Attempts to retrieve a user from the database.</TD></TR><TR><TD CLASS="l">1098</TD><TD>     * </TD></TR><TR><TD CLASS="l">1099</TD><TD>     * @param username</TD></TR><TR><TD CLASS="l">1100</TD><TD>     *            - username of the person to retrieve</TD></TR><TR><TD CLASS="l">1101</TD><TD>     * </TD></TR><TR><TD CLASS="l">1102</TD><TD>     * @return Returns the User associated to the username. Otherwise, returns</TD></TR><TR><TD CLASS="l">1103</TD><TD>     *         null.</TD></TR><TR><TD CLASS="l"><A NAME="20">1104</A></TD><TD>     * </TD></TR><TR><TD CLASS="l">1105</TD><TD>     */</TD></TR><TR><TD CLASS="l">1106</TD><TD>    public static User getUser(String username) {</TD></TR><TR><TD CLASS="l">1107</TD><TD>        try {</TD></TR><TR CLASS="z"><TD CLASS="l">1108</TD><TD>            return dbConnection.getUserByID(username);</TD></TR><TR CLASS="z"><TD CLASS="l">1109</TD><TD>        } catch (SQLException e) {</TD></TR><TR CLASS="z"><TD CLASS="l">1110</TD><TD>            e.printStackTrace();</TD></TR><TR CLASS="z"><TD CLASS="l">1111</TD><TD>            return null;</TD></TR><TR><TD CLASS="l">1112</TD><TD>        }</TD></TR><TR><TD CLASS="l">1113</TD><TD>    }</TD></TR><TR><TD CLASS="l">1114</TD><TD> </TD></TR><TR><TD CLASS="l">1115</TD><TD>    /**</TD></TR><TR><TD CLASS="l">1116</TD><TD>     * Attempts to retrieve a hospital from the database.</TD></TR><TR><TD CLASS="l">1117</TD><TD>     * </TD></TR><TR><TD CLASS="l">1118</TD><TD>     * @param id</TD></TR><TR><TD CLASS="l">1119</TD><TD>     *            - the id of the hospital</TD></TR><TR><TD CLASS="l">1120</TD><TD>     * </TD></TR><TR><TD CLASS="l">1121</TD><TD>     * @return Returns the Hospital associated to the ID. Otherwise, returns</TD></TR><TR><TD CLASS="l"><A NAME="2d">1122</A></TD><TD>     *         null.</TD></TR><TR><TD CLASS="l">1123</TD><TD>     */</TD></TR><TR><TD CLASS="l">1124</TD><TD>    public static Hospital getHospital(int id) {</TD></TR><TR><TD CLASS="l">1125</TD><TD>        try {</TD></TR><TR CLASS="c"><TD CLASS="l">1126</TD><TD>            return dbConnection.getHospitalByID(id);</TD></TR><TR CLASS="z"><TD CLASS="l">1127</TD><TD>        } catch (SQLException e) {</TD></TR><TR CLASS="z"><TD CLASS="l">1128</TD><TD>            e.printStackTrace();</TD></TR><TR CLASS="z"><TD CLASS="l">1129</TD><TD>            return null;</TD></TR><TR><TD CLASS="l">1130</TD><TD>        }</TD></TR><TR><TD CLASS="l">1131</TD><TD>    }</TD></TR><TR><TD CLASS="l">1132</TD><TD> </TD></TR><TR><TD CLASS="l">1133</TD><TD>    /**</TD></TR><TR><TD CLASS="l">1134</TD><TD>     * Attempts to retrieve a client site from the database.</TD></TR><TR><TD CLASS="l">1135</TD><TD>     * </TD></TR><TR><TD CLASS="l">1136</TD><TD>     * @param id</TD></TR><TR><TD CLASS="l">1137</TD><TD>     *            - the id of the client site</TD></TR><TR><TD CLASS="l">1138</TD><TD>     * </TD></TR><TR><TD CLASS="l">1139</TD><TD>     * @return Returns the ClientSite associated to the ID. Otherwise, returns</TD></TR><TR><TD CLASS="l"><A NAME="18">1140</A></TD><TD>     *         null.</TD></TR><TR><TD CLASS="l">1141</TD><TD>     */</TD></TR><TR><TD CLASS="l">1142</TD><TD>    public static ClientSite getClientSite(int id) {</TD></TR><TR><TD CLASS="l">1143</TD><TD>        try {</TD></TR><TR CLASS="z"><TD CLASS="l">1144</TD><TD>            return dbConnection.getClientSiteByID(id);</TD></TR><TR CLASS="z"><TD CLASS="l">1145</TD><TD>        } catch (SQLException e) {</TD></TR><TR CLASS="z"><TD CLASS="l">1146</TD><TD>            e.printStackTrace();</TD></TR><TR CLASS="z"><TD CLASS="l">1147</TD><TD>            return null;</TD></TR><TR><TD CLASS="l">1148</TD><TD>        }</TD></TR><TR><TD CLASS="l">1149</TD><TD>    }</TD></TR><TR><TD CLASS="l">1150</TD><TD> </TD></TR><TR><TD CLASS="l">1151</TD><TD>    /**</TD></TR><TR><TD CLASS="l">1152</TD><TD>     * Attempts to retrieve a user type from the database.</TD></TR><TR><TD CLASS="l">1153</TD><TD>     * </TD></TR><TR><TD CLASS="l">1154</TD><TD>     * @param id</TD></TR><TR><TD CLASS="l">1155</TD><TD>     *            - the id of the user type</TD></TR><TR><TD CLASS="l">1156</TD><TD>     * </TD></TR><TR><TD CLASS="l">1157</TD><TD>     * @return Returns the UserType associated to the ID. Otherwise, returns</TD></TR><TR><TD CLASS="l"><A NAME="23">1158</A></TD><TD>     *         null.</TD></TR><TR><TD CLASS="l">1159</TD><TD>     */</TD></TR><TR><TD CLASS="l">1160</TD><TD>    public static UserType getUserType(int id) {</TD></TR><TR><TD CLASS="l">1161</TD><TD>        try {</TD></TR><TR CLASS="z"><TD CLASS="l">1162</TD><TD>            return dbConnection.getUserTypeByID(id);</TD></TR><TR CLASS="z"><TD CLASS="l">1163</TD><TD>        } catch (SQLException e) {</TD></TR><TR CLASS="z"><TD CLASS="l">1164</TD><TD>            e.printStackTrace();</TD></TR><TR CLASS="z"><TD CLASS="l">1165</TD><TD>            return null;</TD></TR><TR><TD CLASS="l">1166</TD><TD>        }</TD></TR><TR><TD CLASS="l">1167</TD><TD>    }</TD></TR><TR><TD CLASS="l">1168</TD><TD> </TD></TR><TR><TD CLASS="l">1169</TD><TD>    /**</TD></TR><TR><TD CLASS="l">1170</TD><TD>     * Attempts to retrieve a status from the database.</TD></TR><TR><TD CLASS="l">1171</TD><TD>     * </TD></TR><TR><TD CLASS="l">1172</TD><TD>     * @param id</TD></TR><TR><TD CLASS="l">1173</TD><TD>     *            - the id of the status</TD></TR><TR><TD CLASS="l">1174</TD><TD>     * </TD></TR><TR><TD CLASS="l"><A NAME="1f">1175</A></TD><TD>     * @return Returns the Status associated to the ID. Otherwise, returns null.</TD></TR><TR><TD CLASS="l">1176</TD><TD>     */</TD></TR><TR><TD CLASS="l">1177</TD><TD>    public static Status getStatus(int id) {</TD></TR><TR><TD CLASS="l">1178</TD><TD>        try {</TD></TR><TR CLASS="z"><TD CLASS="l">1179</TD><TD>            return dbConnection.getStatusByID(id);</TD></TR><TR CLASS="z"><TD CLASS="l">1180</TD><TD>        } catch (SQLException e) {</TD></TR><TR CLASS="z"><TD CLASS="l">1181</TD><TD>            e.printStackTrace();</TD></TR><TR CLASS="z"><TD CLASS="l">1182</TD><TD>            return null;</TD></TR><TR><TD CLASS="l">1183</TD><TD>        }</TD></TR><TR><TD CLASS="l">1184</TD><TD>    }</TD></TR><TR><TD CLASS="l">1185</TD><TD> </TD></TR><TR><TD CLASS="l">1186</TD><TD>    /**</TD></TR><TR><TD CLASS="l">1187</TD><TD>     * Retrieves shipping information that is relevant to the user based on the</TD></TR><TR><TD CLASS="l">1188</TD><TD>     * parameters used.</TD></TR><TR><TD CLASS="l">1189</TD><TD>     * </TD></TR><TR><TD CLASS="l">1190</TD><TD>     * @param is</TD></TR><TR><TD CLASS="l">1191</TD><TD>     *            - a variable amount of ints where each int represents the id</TD></TR><TR><TD CLASS="l">1192</TD><TD>     *            of a Status</TD></TR><TR><TD CLASS="l">1193</TD><TD>     * </TD></TR><TR><TD CLASS="l">1194</TD><TD>     * @return Returns a map where the key is the id of the Status and the value</TD></TR><TR><TD CLASS="l">1195</TD><TD>     *         is a list of related ShippingInformation to that id.</TD></TR><TR><TD CLASS="l">1196</TD><TD>     */</TD></TR><TR><TD CLASS="l"><A NAME="1c">1197</A></TD><TD>    @SuppressWarnings(&#34;unchecked&#34;)</TD></TR><TR><TD CLASS="l">1198</TD><TD>    public static Map&lt;Integer, List&lt;ShippingInformation&gt;&gt; getReleveantInfo(</TD></TR><TR><TD CLASS="l">1199</TD><TD>            int... is) {</TD></TR><TR><TD CLASS="l">1200</TD><TD> </TD></TR><TR CLASS="z"><TD CLASS="l">1201</TD><TD>        Map&lt;Integer, List&lt;ShippingInformation&gt;&gt; status = new HashMap&lt;Integer, List&lt;ShippingInformation&gt;&gt;();</TD></TR><TR CLASS="z"><TD CLASS="l">1202</TD><TD>        List&lt;ShippingInformation&gt;[] storage = (List&lt;ShippingInformation&gt;[]) new LinkedList[is.length];</TD></TR><TR CLASS="z"><TD CLASS="l">1203</TD><TD>        int[] sortedInput = is.clone();</TD></TR><TR><TD CLASS="l">1204</TD><TD> </TD></TR><TR CLASS="z"><TD CLASS="l">1205</TD><TD>        Arrays.sort(sortedInput);</TD></TR><TR CLASS="z"><TD CLASS="l">1206</TD><TD>        for (int i = 0; i &lt; storage.length; i++) {</TD></TR><TR CLASS="z"><TD CLASS="l">1207</TD><TD>            storage[i] = new LinkedList&lt;ShippingInformation&gt;();</TD></TR><TR><TD CLASS="l">1208</TD><TD>        }</TD></TR><TR><TD CLASS="l">1209</TD><TD> </TD></TR><TR CLASS="z"><TD CLASS="l">1210</TD><TD>        for (ShippingInformation x : getAllShippingInformation()) {</TD></TR><TR CLASS="z"><TD CLASS="l">1211</TD><TD>            for (int i = 0; i &lt; is.length; i++) {</TD></TR><TR CLASS="z"><TD CLASS="l">1212</TD><TD>                if (sortedInput[i] == x.status.status_id) {</TD></TR><TR CLASS="z"><TD CLASS="l">1213</TD><TD>                    storage[i].add(x);</TD></TR><TR CLASS="z"><TD CLASS="l">1214</TD><TD>                    break;</TD></TR><TR><TD CLASS="l">1215</TD><TD>                }</TD></TR><TR><TD CLASS="l">1216</TD><TD>            }</TD></TR><TR><TD CLASS="l">1217</TD><TD>        }</TD></TR><TR><TD CLASS="l">1218</TD><TD> </TD></TR><TR CLASS="z"><TD CLASS="l">1219</TD><TD>        for (int i = 0; i &lt; storage.length; i++) {</TD></TR><TR CLASS="z"><TD CLASS="l">1220</TD><TD>            status.put(sortedInput[i], storage[i]);</TD></TR><TR><TD CLASS="l">1221</TD><TD>        }</TD></TR><TR><TD CLASS="l">1222</TD><TD> </TD></TR><TR CLASS="z"><TD CLASS="l">1223</TD><TD>        return status;</TD></TR><TR><TD CLASS="l">1224</TD><TD>    }</TD></TR><TR><TD CLASS="l">1225</TD><TD> </TD></TR><TR><TD CLASS="l">1226</TD><TD>    /**</TD></TR><TR><TD CLASS="l">1227</TD><TD>     * Attempts to retrieve all packages that are marked as &#34;In Transit&#34; or</TD></TR><TR><TD CLASS="l">1228</TD><TD>     * &#34;Waiting&#34; to be picked up.</TD></TR><TR><TD CLASS="l">1229</TD><TD>     * </TD></TR><TR><TD CLASS="l">1230</TD><TD>     * @return Returns a &lt;code&gt;List&amp;lt;ShippingInformation&amp;gt;&lt;/code&gt; object</TD></TR><TR><TD CLASS="l"><A NAME="1a">1231</A></TD><TD>     *         containing all the packages that are in transit or yet to be</TD></TR><TR><TD CLASS="l">1232</TD><TD>     *         picked up. Otherwise, returns &lt;code&gt;null&lt;/code&gt;</TD></TR><TR><TD CLASS="l">1233</TD><TD>     */</TD></TR><TR><TD CLASS="l">1234</TD><TD>    public static List&lt;ShippingInformation&gt; getCurrentPackages() {</TD></TR><TR CLASS="z"><TD CLASS="l">1235</TD><TD>        noConnection();</TD></TR><TR><TD CLASS="l">1236</TD><TD>        try {</TD></TR><TR CLASS="z"><TD CLASS="l">1237</TD><TD>            return dbConnection.getNotArrived();</TD></TR><TR CLASS="z"><TD CLASS="l">1238</TD><TD>        } catch (SQLException e) {</TD></TR><TR CLASS="z"><TD CLASS="l">1239</TD><TD>            e.printStackTrace();</TD></TR><TR CLASS="z"><TD CLASS="l">1240</TD><TD>            return null;</TD></TR><TR><TD CLASS="l">1241</TD><TD>        }</TD></TR><TR><TD CLASS="l">1242</TD><TD> </TD></TR><TR><TD CLASS="l">1243</TD><TD>    }</TD></TR><TR><TD CLASS="l">1244</TD><TD> </TD></TR><TR><TD CLASS="l">1245</TD><TD>    /**</TD></TR><TR><TD CLASS="l">1246</TD><TD>     * Attempts to retrieve all specimens assigned to the given username.</TD></TR><TR><TD CLASS="l">1247</TD><TD>     * </TD></TR><TR><TD CLASS="l">1248</TD><TD>     * @param username</TD></TR><TR><TD CLASS="l">1249</TD><TD>     *            - username to be looked up for specimens</TD></TR><TR><TD CLASS="l">1250</TD><TD>     * </TD></TR><TR><TD CLASS="l">1251</TD><TD>     * @return Returns a &lt;code&gt;List&amp;lt;ShippingInformation&amp;gt;&lt;/code&gt; object</TD></TR><TR><TD CLASS="l">1252</TD><TD>     *         containing all the packages that are associated to the given</TD></TR><TR><TD CLASS="l"><A NAME="14">1253</A></TD><TD>     *         username. Otherwise, returns &lt;code&gt;null&lt;/code&gt;</TD></TR><TR><TD CLASS="l">1254</TD><TD>     */</TD></TR><TR><TD CLASS="l">1255</TD><TD>    public static List&lt;ShippingInformation&gt; getAllSpecimensByUsername(</TD></TR><TR><TD CLASS="l">1256</TD><TD>            String username) {</TD></TR><TR CLASS="z"><TD CLASS="l">1257</TD><TD>        return getAllSpecHelper(username, true);</TD></TR><TR><TD CLASS="l">1258</TD><TD>    }</TD></TR><TR><TD CLASS="l">1259</TD><TD> </TD></TR><TR><TD CLASS="l">1260</TD><TD>    /**</TD></TR><TR><TD CLASS="l">1261</TD><TD>     * Attempts to retrieve all specimens assigned to the given name.</TD></TR><TR><TD CLASS="l">1262</TD><TD>     * </TD></TR><TR><TD CLASS="l">1263</TD><TD>     * @param name</TD></TR><TR><TD CLASS="l">1264</TD><TD>     *            - name to be looked up for specimens</TD></TR><TR><TD CLASS="l">1265</TD><TD>     * </TD></TR><TR><TD CLASS="l">1266</TD><TD>     * @return Returns a &lt;code&gt;List&amp;lt;ShippingInformation&amp;gt;&lt;/code&gt; object</TD></TR><TR><TD CLASS="l"><A NAME="13">1267</A></TD><TD>     *         containing all the packages that are associated to the given</TD></TR><TR><TD CLASS="l">1268</TD><TD>     *         name. Otherwise, returns &lt;code&gt;null&lt;/code&gt;</TD></TR><TR><TD CLASS="l">1269</TD><TD>     */</TD></TR><TR><TD CLASS="l">1270</TD><TD>    public static List&lt;ShippingInformation&gt; getAllSpecimensByName(String name) {</TD></TR><TR CLASS="z"><TD CLASS="l">1271</TD><TD>        return getAllSpecHelper(name, false);</TD></TR><TR><TD CLASS="l">1272</TD><TD>    }</TD></TR><TR><TD CLASS="l">1273</TD><TD> </TD></TR><TR><TD CLASS="l">1274</TD><TD>    // ----------------------------------------------------------------------------</TD></TR><TR><TD CLASS="l">1275</TD><TD>    // Android server specific</TD></TR><TR><TD CLASS="l">1276</TD><TD>    // ----------------------------------------------------------------------------</TD></TR><TR><TD CLASS="l">1277</TD><TD> </TD></TR><TR><TD CLASS="l">1278</TD><TD>    /**</TD></TR><TR><TD CLASS="l">1279</TD><TD>     * Attempts to update the GPS of a courier.</TD></TR><TR><TD CLASS="l">1280</TD><TD>     * </TD></TR><TR><TD CLASS="l">1281</TD><TD>     * @param username</TD></TR><TR><TD CLASS="l">1282</TD><TD>     *            - username of the courier</TD></TR><TR><TD CLASS="l">1283</TD><TD>     * @param latitude</TD></TR><TR><TD CLASS="l">1284</TD><TD>     *            - latitude of the courier</TD></TR><TR><TD CLASS="l">1285</TD><TD>     * @param longitude</TD></TR><TR><TD CLASS="l">1286</TD><TD>     *            -longitude of the courier</TD></TR><TR><TD CLASS="l"><A NAME="28">1287</A></TD><TD>     */</TD></TR><TR><TD CLASS="l">1288</TD><TD>    public static void updateGPS(String username, double latitude,</TD></TR><TR><TD CLASS="l">1289</TD><TD>            double longitude) {</TD></TR><TR><TD CLASS="l">1290</TD><TD> </TD></TR><TR CLASS="z"><TD CLASS="l">1291</TD><TD>        noConnection();</TD></TR><TR><TD CLASS="l">1292</TD><TD> </TD></TR><TR CLASS="z"><TD CLASS="l">1293</TD><TD>        if (noNulls(username, getCourierInfo(username))) {</TD></TR><TR CLASS="z"><TD CLASS="l">1294</TD><TD>            Courier temp = getCourierInfo(username);</TD></TR><TR><TD CLASS="l">1295</TD><TD>            try {</TD></TR><TR CLASS="z"><TD CLASS="l">1296</TD><TD>                dbConnection.changeRecord(new Courier(temp.user, temp.route,</TD></TR><TR CLASS="z"><TD CLASS="l">1297</TD><TD>                        latitude, longitude, temp.nextDest));</TD></TR><TR CLASS="z"><TD CLASS="l">1298</TD><TD>            } catch (SQLException e) {</TD></TR><TR CLASS="z"><TD CLASS="l">1299</TD><TD>                e.printStackTrace();</TD></TR><TR><TD CLASS="l">1300</TD><TD>            }</TD></TR><TR><TD CLASS="l">1301</TD><TD>        } else {</TD></TR><TR CLASS="z"><TD CLASS="l">1302</TD><TD>            logger.info(&#34;GPS Update failed: username or courier is null&#34;);</TD></TR><TR><TD CLASS="l">1303</TD><TD>        }</TD></TR><TR><TD CLASS="l">1304</TD><TD> </TD></TR><TR CLASS="z"><TD CLASS="l">1305</TD><TD>    }</TD></TR><TR><TD CLASS="l">1306</TD><TD> </TD></TR><TR><TD CLASS="l">1307</TD><TD>    /**</TD></TR><TR><TD CLASS="l">1308</TD><TD>     * Changes the status of a shipment to &#34;Picked Up.&#34;</TD></TR><TR><TD CLASS="l">1309</TD><TD>     * </TD></TR><TR><TD CLASS="l">1310</TD><TD>     * @param barcode</TD></TR><TR><TD CLASS="l">1311</TD><TD>     *            - the barcode of the shipment</TD></TR><TR><TD CLASS="l"><A NAME="24">1312</A></TD><TD>     * </TD></TR><TR><TD CLASS="l">1313</TD><TD>     * @return Returns true if change was successful. Otherwise, returns false.</TD></TR><TR><TD CLASS="l">1314</TD><TD>     */</TD></TR><TR><TD CLASS="l">1315</TD><TD>    public static boolean pickedUp(String barcode) {</TD></TR><TR CLASS="z"><TD CLASS="l">1316</TD><TD>        if (noNulls(barcode, getShippingInfo(barcode))) {</TD></TR><TR CLASS="z"><TD CLASS="l">1317</TD><TD>            ShippingInformation temp = getShippingInfo(barcode);</TD></TR><TR CLASS="z"><TD CLASS="l">1318</TD><TD>            changeShippingInformation(barcode, temp.shipper.username,</TD></TR><TR CLASS="z"><TD CLASS="l">1319</TD><TD>                    temp.destination.client_id, 2, temp.courier.user.username);</TD></TR><TR CLASS="z"><TD CLASS="l">1320</TD><TD>            return true;</TD></TR><TR><TD CLASS="l">1321</TD><TD>        } else {</TD></TR><TR CLASS="z"><TD CLASS="l">1322</TD><TD>            return false;</TD></TR><TR><TD CLASS="l">1323</TD><TD>        }</TD></TR><TR><TD CLASS="l">1324</TD><TD>    }</TD></TR><TR><TD CLASS="l">1325</TD><TD> </TD></TR><TR><TD CLASS="l">1326</TD><TD>    // ----------------------------------------------------------------------------</TD></TR><TR><TD CLASS="l">1327</TD><TD>    // Helper methods</TD></TR><TR><TD CLASS="l">1328</TD><TD>    // ----------------------------------------------------------------------------</TD></TR><TR><TD CLASS="l">1329</TD><TD> </TD></TR><TR><TD CLASS="l">1330</TD><TD>    /**</TD></TR><TR><TD CLASS="l"><A NAME="2b">1331</A></TD><TD>     * Helper that throws an exception if there is no connection to the</TD></TR><TR><TD CLASS="l">1332</TD><TD>     * database.</TD></TR><TR><TD CLASS="l">1333</TD><TD>     */</TD></TR><TR><TD CLASS="l">1334</TD><TD>    private static void noConnection() throws IllegalStateException {</TD></TR><TR CLASS="c"><TD CLASS="l">1335</TD><TD>        if (dbConnection == null) {</TD></TR><TR CLASS="z"><TD CLASS="l">1336</TD><TD>            throw new IllegalStateException(&#34;Connection to the database&#34;</TD></TR><TR><TD CLASS="l">1337</TD><TD>                    + &#34;has not bee made&#34;);</TD></TR><TR><TD CLASS="l">1338</TD><TD>        }</TD></TR><TR CLASS="c"><TD CLASS="l">1339</TD><TD>    }</TD></TR><TR><TD CLASS="l">1340</TD><TD> </TD></TR><TR><TD CLASS="l">1341</TD><TD>    /**</TD></TR><TR><TD CLASS="l">1342</TD><TD>     * @deprecated Deprecated method that checks to see if courier is at</TD></TR><TR><TD CLASS="l"><A NAME="b">1343</A></TD><TD>     *             nextDest.</TD></TR><TR><TD CLASS="l">1344</TD><TD>     */</TD></TR><TR><TD CLASS="l">1345</TD><TD>    @SuppressWarnings(&#34;unused&#34;)</TD></TR><TR><TD CLASS="l">1346</TD><TD>    private static boolean checkLoc(Courier courier, ClientSite specLoc) {</TD></TR><TR CLASS="z"><TD CLASS="l">1347</TD><TD>        return courier.route.indexOf(courier.nextDest) &lt;= courier.route</TD></TR><TR CLASS="z"><TD CLASS="l">1348</TD><TD>                .indexOf(specLoc);</TD></TR><TR><TD CLASS="l">1349</TD><TD>    }</TD></TR><TR><TD CLASS="l">1350</TD><TD> </TD></TR><TR><TD CLASS="l">1351</TD><TD>    /**</TD></TR><TR><TD CLASS="l">1352</TD><TD>     * Get specimen of certain couriers based on either their username or first</TD></TR><TR><TD CLASS="l"><A NAME="11">1353</A></TD><TD>     * name.</TD></TR><TR><TD CLASS="l">1354</TD><TD>     */</TD></TR><TR><TD CLASS="l">1355</TD><TD>    private static List&lt;ShippingInformation&gt; getAllSpecHelper(String s,</TD></TR><TR><TD CLASS="l">1356</TD><TD>            boolean username) {</TD></TR><TR CLASS="z"><TD CLASS="l">1357</TD><TD>        List&lt;ShippingInformation&gt; temp = new LinkedList&lt;ShippingInformation&gt;();</TD></TR><TR><TD CLASS="l">1358</TD><TD> </TD></TR><TR CLASS="z"><TD CLASS="l">1359</TD><TD>        for (ShippingInformation x : getAllShippingInformation()) {</TD></TR><TR CLASS="z"><TD CLASS="l">1360</TD><TD>            if ((username &amp;&amp; x.courier.user.username == s)</TD></TR><TR CLASS="z"><TD CLASS="l">1361</TD><TD>                    || (!username &amp;&amp; x.courier.user.fname == s)) {</TD></TR><TR CLASS="z"><TD CLASS="l">1362</TD><TD>                temp.add(x);</TD></TR><TR><TD CLASS="l">1363</TD><TD>            }</TD></TR><TR><TD CLASS="l">1364</TD><TD>        }</TD></TR><TR CLASS="z"><TD CLASS="l">1365</TD><TD>        return temp;</TD></TR><TR><TD CLASS="l">1366</TD><TD>    }</TD></TR><TR><TD CLASS="l">1367</TD><TD> </TD></TR><TR><TD CLASS="l"><A NAME="32">1368</A></TD><TD>    /**</TD></TR><TR><TD CLASS="l">1369</TD><TD>     * Helper that checks to make sure length of strings aren't 0.</TD></TR><TR><TD CLASS="l">1370</TD><TD>     */</TD></TR><TR><TD CLASS="l">1371</TD><TD>    private static boolean lengthChecker(String... strings) {</TD></TR><TR CLASS="c"><TD CLASS="l">1372</TD><TD>        for (int i = 0; i &lt; strings.length; i++) {</TD></TR><TR CLASS="c"><TD CLASS="l">1373</TD><TD>            if (strings[i].length() == 0) {</TD></TR><TR CLASS="z"><TD CLASS="l">1374</TD><TD>                return false;</TD></TR><TR><TD CLASS="l">1375</TD><TD>            }</TD></TR><TR><TD CLASS="l">1376</TD><TD>        }</TD></TR><TR CLASS="c"><TD CLASS="l">1377</TD><TD>        return true;</TD></TR><TR><TD CLASS="l">1378</TD><TD>    }</TD></TR><TR><TD CLASS="l">1379</TD><TD>}</TD></TR></TABLE><P></P><TABLE CLASS="hdft" CELLSPACING="0" WIDTH="100%"><TR><TD CLASS="nv">[<A HREF="../FeatureReleaseEmmaReport.html">all classes</A>][<A HREF="5.html">jvm.jtacck.db</A>]</TD></TR><TR><TD CLASS="tl"><A HREF="http://www.eclemma.org/support.html">EMMA 2.0.5312 EclEmma Fix 2</A> (C) Vladimir Roubtsov</TD></TR></TABLE></BODY></HTML>